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ABSTRACT 


Managing large software development projects and 
delivering them on time and within budget has proven to be a 
difficult task. The Dynamica Model of Software Project 
Management, has been designed to support the management of 
the software development process. The current interface to 
the model, however, is not suited to the inexperienced user. 

The objective of this thesis is to enhance the usability 
and acceptance of the Dynamica Model of Software Project 
Management. The design of the user interface accomplished in 
this thesis is an attempt to provide the maximum benefit of 
the model to the user by simplifying the process of uSing, 
viewing, and storing results from the model. This allows 
the user to focus his or her attention on design 
considerations and interpreting model experiments. 

Specifically the accomplishments of this th2sis include 
the development of a menu system which provides a logical 
format for accessing the Dynamica model and the creation of a 
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I. INTRODUCTION 


A. BACKGROUND 

In recent years, rapid technological advancements in 
computer hardware, and the ensuing cost reduction of 
equipment, has increased the demand for hardware and 
consequently the demand on software. A tenfold increase in 
software demand is expected over the next 1C years [Re€. 
mae. 55-62). 

However, the growth in the software industry has not been 
painless. There are currently numerous problems facing 
software project managers. Software development projects 
have been marked by cost overruns, late deliveries, poor 
reliability and user dissatisfaction [{Ref. 2:pp. 36-41] and 
(Ref. 3:pp. 132-142). Only recently has the software project 
manager seen the development of an assortment of "tools" to 
ald him in estimating, tracking and forecasting costs, 
scheduling completion dates, and in the myriad of other tasks 
which are integral parts of the software development process. 

The Dynamica Model of Software Project Management, 
created by Tarek K. Abdel-Hamid while at the Massachusetts 
Mmistitute o£ Technology, is one of the exciting new "tools" 
recently developed. It is a comprehensive model of the 
software development process. Written in Professional 


Dynamo, the model integrates both the management-type 


functions (e.9., planning Control, and @stattius) e- taeene 
software production-type activities (e.g., design, coding, 
reviewing and testing). 

The Dynamica Model of Software Management can perform 
several important roles. ItsS main goal is to aid the 
software project manager in understanding the software 
development process. The manager can conduct "what if" 
experiments with the model to develop a more comprehensive 
understanding of the interrelationships of software 
development variables. For example, what is the impact on 
project cost of an increase in quality asSurance effort. The 
model allows the user to track, store, graph and plot large 
amounts of project data, quickly and efficiently. In so 
doing, the user can improve and fine tune his fundamental 
understanding of the software development process through the 
advantages gained by using a computer simulation model. 

secondly, the Dynamica model can be used to aid the 
software project manager in the actual management process. 
For example, the model can be utilized to estimate project 
cost, schedule completion time, and numerous other variables. 
Variables ina software development project can be changed 
and simulations can be run ina matter of minutes. This 
allows the manager to evaluate different management 


strategies. 


Currently the Dynamica model interface is limited to 
Simulations performed by the experienced model user. The 
model does not provide the new user with any assistance or 
guidance. For example, the model does not define the 
variables in the model or explain what options are available 
to the user. 

To provide the maximum benefits from any computer based 
system, great care must be taken in the design of the human 
interface. User friendly systems are much more likely to 
gain wide spread acceptance. Learning to use and operate a 
computer based system must be easy enough for the beginner 
yet flexible enough not to constrain more experienced users. 
The interface of the system, must stress simplicity and 
efficiency without limiting the users creativity. The 
interface should be designed to focus the users attention on 
important information and not clutter the screen with 
inconsequential data. Feedback should be provided ina 


timely manner to Keep the users attention. 


B PURPOSE OF RESEARCH 

The objective of this thesis is to enhance the 
effectiveness of the Dynamica Model of Software Management by 
providing an improved user interface which enhances the 
usefulness of the model for a wide range of users. 

This is accomplished by determining the most commonly 
used functions of the Dynamica model and designing a system 
to allow the user a simple method of access to them. The 
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design of the model interface should build upon and 
complement the menu interface available in Professional 
Dynamo. The interface should be self documenting and lead 
the user through the process of selecting variables, running 
Simulations and storing results. It should also allow the 
user to avoid the documentation as his/her experience level 
grows. Since a major purpose of the Dynamica model is to 
enhance the user's understanding of the software development 
process, the interface shoul” ,rovide the tools the user 
needs for accessing, and analyzing all critical data created 


by the model. 


C. SCOPEVCr RESEARCH 

The scope of this research will include the design and 
development of a user interface for the Dynamica model 
utilizing the executive level interface of Professional 
Dynamo - Dynex, DOS batch files, and the Extended Batch 
Language (EBL) menu facility EXECMAKE. The model 
documentation included in this thesis will in addition 


comprise a user's manual for the system. 


D. THESIS ORGANIZATION 

Chapter II will briefly discuss problem areas in the 
current methods of software project management and the role 
of the Dynamica Model of Software Project Management to solve 
those problems. The user interface developed in this thesis 


Will be thoroughly demonstrated in Chapter III. In Chapter 


IV we discuss the system architecture for the user interface 
developed in this thesis, and discuss the interrelationships 


of the sub components of the interface. 


II. RESEARCH BACKGROUND AND OBJECTIVES 


A. CURRENT PROBLEMS IN SOFTWARE PROJECT MANAGEMENT 
There has been tremendous growth in the demand for 
software systems over the past 20 years. The software 
development process unfortunately, has earned an "infamous" 
reputation for cost overruns, late deliveries, poor 
reliability and users’ dissatisfaction (Ket. Z:pp. 36-41) vage 
URES. S20 sca za 
While significant progress has been made over the past 20 
years in improving the technology of software development, 
little research effort has been devoted to the managerial 
issues. 
software Engineering Project Management (SEPM) has not 
enjoyed the same progress (as the technology of software 
development). While it might be argued that SEPM has 
been defined, it is far from a recognized discipline. .=.- 
The major issues and problems of SEPM have not been 
agreed on by the computing community as a whole, and 
consequently, priorities for addressing them have not 


been widely established. Furthermore, research in this 
area has been scant. (Ref. 4:p. 333] 


B. THE DYNAMICA MODEL 

The goal of the Dynamica model is to provide an 
understanding of the dynamic behavior of software projects 
and support the management of the software development 


process [Kket.. 5*op. 8-10.12 


The Dynamica model is a comprehensive system dynamics 
model of the software development process. The model 
integrates the multiple functions of the software development 
process, including both the management-type functions (e.g., 
panning, control, staffing) as well as the software 
production-type activities (e.g., design, coding, reviewing, 
testing) [{Ref. 6G:pp. 6-11]. Such an integrative approach is 
useful since it would prompt and facilitate a search for the 
multiple, and potentially diffuse set of factors that are 
interacting to cause some software project problem(s) (Ref. 
Gp. 14). 

Another distinctive aspect of the Dynamica model is its 
use of computer simulation techniques to handle the high 
complexity of the integrative feedback model. 

The behavior of systems of interconnected feedback loops 
often confounds common intuition and analysis, even 
though the dynamic implications of isolated loops may be 
reasonably obvious. The feedback structures of real 
problems are often so complex that the behavior they 
generate over time can usually be traced only by 
Simulation. pee tae pmo —7 | 

The Dynamica model consists of the four subsystems shown 
in Figure 2-1 [Ref. 5:p. 12]. The Human Resource Management 
Subsystem captures tne hiring, training, assimilation and 
transfer of the project's human resources. The Software 
Production Subsystem captures the design, coding, quality 


Peiaanice, ceWorkK, and Eesting activities (Ref. 6:pp. 11-25]. 


The Planning Subsystem models the scheduling activities that 


fake place throughout the project*s lite cycle. | ines eonera: 


Subsystem captures the measurement of progress on the 








OHroj ect. 
HUMAN 
RESOURCE 
MANAGEMENT 
progress iy, | \ workforce 
status needed 
yi, | A 
yf \ 
y a 
SOFTWARE \ 
/ PRODUCTION : 
/ 
de ee ix \ 
tasks completed schedule \ 
ae \ \ 
ie \ 
/ YO \ \ 
CONTROLLING es a ee ee > PLANNING 
effort remaining 
Figure 2-1. Four Subsystems of The Dynamica model 
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The goal of this thesis is to design and develop a user 
interface for the Dynamica model which would improve the 
Dynamica model's utility as both a learning tool anda 
management support system. Three areas of the model 


interface are targeted for improvement: (1) ease of 


Operation, (2) improved facilities for accessing, storing and 
reviewing simulation results and (3) improved method of 
variable manipulation. 

The Dynamica model currently is extremely difficult for 
the new user to operate. For example, the model does not 
provide the user with a clear guide for operation and there 
is no online help or documentation available. These problem 
areas will be addressed through the design of a new menu type 
interface. The menu system will outline the £Eunctions 
available within the Dynamica model, explaining these 
functions, and make them easy to access and invoke. 

One of the major advantages of the Dynamica Simulation 
model is its capability to provide the user with a dynamic 
and detailed picture of how model variables change throughout 
the project's life cycle. One of the goals of this thesis is 
to provide the user a easy method for data storage as well as 
Gegotring, graphing and printing the simulation results. 

A standardized report format and plot functions will be made 
available to the user via the menu system. 

Finally, the Dynamica model needs to provide the user 
with a framework for manipulating variables and controlling 
the model. Professional Dynamo provides the experienced 
model builder an executive interface language, Dynex, for 
Creating an easily understood format for model manipulation. 


A goal of this thesis is the design and coding of a dynex 


interface for the model. This interface will) contains 
definitions of 18 selected variables and allow their 


manipulation within the model. 
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Pie Oe Deo LGN 


fee LNTRODUCTION 

This chapter provides a detailed description of the user 
interface. It provides explanatory information on the 
portions of the interface visible to the user. In effect, it 
is a manual for the system, providing guidance on operating 
the system and explaining its characteristics. 

The user interface for the DYNAMICA MODEL OF SOFTWARE 
MANAGEMENT consists of three main parts: (1) the Model Menu 
and its Submenus, (2) 24 batch files called by the Model Menu 
and (3) the Model interface written in DYNEX (the executive 
interface language of Professional Dynamo). 

To operate the Dynamica model requires an IBM or IBM 
compatible XT/AT microcomputer, with 640 K of RAM and either 
mmeaad Gisk or L.2 meq floppy disk. Microsoft (MS) or 
Personal Computer (PC) DOS 2.xx or greater is also required. 

section B of this chapter contains a complete tour of the 


user interface. 


B. THE MAIN MODEL MENU AND ITS SUBMENUS 

To initiate the main Model Menu type (menu) followed by 
mee return at the DOS prompt of Ehe directory containing 
Whe files of the system disk. Figure 3-1 will appear on the 
display. (For uniformity and clarity when reading interface 
documentation or prompts, the keystrokes required as input 
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will be placed in parenthesis. Uniess otherwise stated, 
input may be lower or upper case.) 
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MODEL MENU 
FOR THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 


KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KK KKK KKK KKK KK KK KKK 


1. INTRODUCTION TO THE MODEL MENU 
2. HELP BPACTEITIECsS 

3. VARIABLE MANIPULATION 

4. RUN SIMULATIONS 

5. TO STORE AND PRINT RESULTS 

6. VIEW RESULTS AND PRINT GRAPHS 
i. GER Tees Os 


Choose an option: (ESC exits menu) 


Figure 3-1. The Model Menu 


The user needs only to type the number of his/her 
selection and follow the prompts to move through any of the 
menu items selected. Pressing the escape Key at any submenu 
will return the user to the next higher level menu until 
reaching the Model Menu's main screen Figure 3-1. 

The Model Menu provides the user six topic areas to 
choose from. Menu options are explained below in the order 
listed in the Model Menu of Figure 3-1. All submenus of an 
option (e.g., selecting option 1 provides the user a submenu 
of the same title with three additional selections) will be 


discussed before proceeding to the next menu selection. 


BE 


The first option on the main menu is INTRODUCTION TO THE 
MODEL MENU. I€£ selected, the user is presented the submenu 


sow in Figure 3-2. 
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PNERODUCT IONS IO STE eMODEE MENU 
THE FOLLOWING MENU PROVIDES INTRODUCTORY INFORMATION TO 
NEW USERS 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KK KK 


ioe Ore Osh CF Tne HObEL MENU 
2. HARDWARE/SOFTWARE REQUIREMENTS 
So SUGGESTIONS FOR USING Tak MENU 


Choose an option: (ESC exits menu) 


Pigure 3 +2. Introduction to the Model Menu 


The three user selections available in Figure 3-2, provide 
introductory information on the operation of the model menu. 
The three selections are (1) Purpose of the Model Menu, (2) 
Hardware/Software Requirements, and (3) Suggestions for 
Meang the Menu, Figures 3-3, 3-4 and 3-5. 

After returning to the main Model Menu, selection of 
option # 2, Help Facilities, provides the user access to the 


submenu shown in Figure 3-6. 


ie, 
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WELCOME 


KER KKK KR KR KK RK KK KK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KK KKK KKK KK 


WELC Cee! On THE SMO DE Ga eeepc eet bla 
LETS DISCUSS WHAT THE MODEL MENU IS AND WHAT 
IT ISN'T, TO BOPEPULEY SVClUS AM Seco USGA s sou 
BEGIN TO FAMILIARIZE YOURSELF WITH THE DYNAMICA 
MODEL OF SOFTWARE PROJECT MANAGEMENT. 


I. COMPONENTS OF THE MODEL MENU 


THE DYNAMICA HODEL OF S@RIWARE PROJECT 
MANAGEMENT IS A SOPHISTICATED SIMULATION MODEL 
WRITTEN BY DR. TAREK K.ABDEL-HAMID, IN PROFESSIONAL 
DYNAMO. PROFESSIONAL DYNAMO (ABBREVIATED PD ) [5S 
A HIGH LEVEL SIMULATION LANGUAGE CREATED BY PUGH —- 
ROBERTS ASSOCIATES, INC. 

ACCESS 70 THE SYSTEM DYNAMICS eUODE Eee: 

SOFTWARE MANAGEMENT IS PROVIDED BY THE MODEL MENU. 

THE MODEL MENU, WRITTEN USING EXTENDED BATCH LANGUAGE, 
DOS COMMANDS, SEVERAL PUBLIC DOMAIN BATCH FILE 
UTILITIES AND THE PD INTERFACE LANGUAGE DYNEX, HAS 
BEEN DESIGNED 10 BASE AND cet ED MUSE R Cercle me 
MODEL AND AID IN THE MANIPULATION OF SIMULATION 
Reo Se 


HiT ANY KEY TORCon TENG: 


Figure 3-3. Purpose o£ the Model Menu 
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HARDWARE AND SOFTWARE REQUIREMENTS 


KKK KKK KKK KKK KKK KKK KEKE KEKE KKK KEK KEK KKK KKK KKK KKK KK KKK KKK KKK KK KEK 


HARDWARE: 


Tice ooOb ween OULKES SANT BMSOK IBM COMPATIBLE 
AT/AT MICROCOMPUTER, WITH 640 K OF RAM AND A HARD 
iow OR 1.2 MEG PLOPPY. 


Ex,cecULEON OF M@BEL SEMULATIONS IS A VERY 
HMMERTCALLY INIENSIVE OPERATION. TRE EXECUTION 
SPEED INCREASES TREMENDOUSLY WITH THE USE OF A MATH 
COar ROCHE SoOR ChlP. 


Pi eVOve Seer nOvLDES SUPPOKRI POR THE MOST COMMON 
GRAPHIC DISPLAY MODES, MDA, CGA AND EGA. THE MODEL'S 
om OF eCOLOK LS BESIGNED TO ENHANCE USABILITY BUT IS 
NOT A REQUIREMENT. 

SOFTWARE: 

tO ewer omission PC DOS 2.xx OR GREATER. 
See Oma oUR eis Lhe FREES LISTED ON THE SYSTEM 
DISK ARE PRESENT IF ANY PROBLEMS ARISE. 


ait any KEY TO )CONTINUE 


Figure 3-4. Hardware and Software Requirements 


ihe: 
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SUGGESTIONS 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK 


THE FIRST RECOMMENDED SOKDER Of SB uw geomor 
ALL NEW OSERS 13S TO WPAMIDGIAKIZE /OURSBEV SS tree 
MODEL MENU. TAKE A FEW MOMENTS AND EXPLORE ALL THE 
MENU SELECTIONS. THERE IS NO NEED SIGS ENTERetATA OR 
RESPOND TO ANY OF THE QUEKI VS 7 Us! Seeawe Une oC nh Meire 
AND HIT ENTER OR ANY KEY AS PROMPTED TO CONTINUE. 
THIS WHOLE PROCESS so nOULDSONEVSLAKE YOUR IO SENG TEs 
OR Soe 


HIT ANY KEY Si@ conti iG 


Figure 3-5.1. Suggestions tom Wsing Enesltode!l 
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REVIEW THE MODEL VARIABLES 


KR KKK KK KEK KEK KKK KK KKK KKK KKK KEK KKK KK KK KKK KK KKK KKK KEK KEKE KK KKK KK KKK 


IF YOU PLAN. TOSUSE TRE MODE ES es MUA TE a 
PARTICULAR SOFTWARE PROJECT THAT YOU HAVE DATA ON, 
THE MODEL: SHOULD BE CUSTOMIZED iO eRe EEGt Sino 
PROJECT. YOUR FIRST STEP TOWARDS (HAT COAR BOF MODEL 
PARAMETERIZATION {1S 1O REVIEW THE Cee eis 307 
THE ADJUSTABLE VARIABLES Wi TaD N thE iOD aie olen 
DEFINITIONS ARE AVAILABLE, BY VSsEEEC Pre NGat 23, 
VARIABLE MANIPULATION FROM THE MODEL MENU. 


HIT ANY KEY [6 COh@eNuUE 


Figure 3-5.2. Suggestions for Using the Menu 
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abe ee herr irs 
INTRODUCTION TO DYNAMICA AND PROFESSIONAL 
DYNAMO HELP FACILITIES 


KKK KKK KKK KK KKK KKK KKK KK HK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK 


TOvVERViMW Or HELP FACILITIES 
2. ONLINE MODEL HELP INFORMATION 


3. PROFESSIONAL DYNAMO HELP 
Choose an option: (ESC exits menu) 


Figure 3-6. Help Facilities 


selection # 1, Overview of Help Facilities, provides the 


user with an explanation of the two types of help facilities 


available in the model Figure 3-7. 


keke Ke KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK 


OVERVIEW OF AVATLABLE HELP FACILITIES 
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Gee hoeeke ONO TYPES OF HELP AVAILABLE TO THE USER: 


Ce eh GENE MODE te iy 
(2) PROFESSIONAL DYNAMO HELP 


ob ONDINE MODEL HELP IS AVAILABLE TO THE USER 
VEEN UTTEEAZING SELECTION #° 3° 0F THE MAIN MENU - 
VARIABLE MANIPULATION. AT ANY PROMPT, THE USER 
Vit SCY eres (heh hP (HELP £O GET A LIST OF 


PVePSASLE HELP CATEGORIES. 
(2) PROFESSIONAL DYNAMO HELP PROVIDES THE MORE 


Pree See MODEL USER ACCESs TO 8 PD HELP TOPICS. 
feet aN Ke TO SCONTENUE 


Figure 3-7. Overview of Help Facilities 


Ley 


Selection # 2, Online Model Help Information, explains 
the operation and capabilities of online model help Figure 
3-8. 

Selection # 3 , Professional Dynamo Help, presents the 
user a submenu containing a list of the PD Help Facilities 
available Figure 3-9. Professional Dynamo Help is listed in 


Appendix C. 
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ONLINE MODEL HELP INFORMATION 


KKK KKK KK KKK KK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KK KKK KK KKK KKK KK 


THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGE- 
MENT HAS THE CAPABILITY FOR BXATENSIVE, USER VDE Iie 
BASILY MODIFIABLE HELP. ACCESS TO THiSeRaeEe Es 
AVAILABLE WHILE UTILIZING MAIN MENU SELECTION # 3, 
MODEL & VARIABLE MANIPULATION. THIS HELP CAPABILITY 
IS A FEATURE OF PROFESSIONAL DYNAMO, DESIGNED BY 
PUGH-ROBERTS AsSOGL AIRS bhice 


TO ACCESS AN EXAMPLE OF THIS HELP, THE USER 
SIMPLY TYPES (HJEEP (HJEGe Oconee Soha. 


HIT ANY KEY TO CoWwTINUE 


Figure 3-8. Online Model Help intenmacicn 
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PROFESSIONAL DYNAMO HELP 
THE FOLLOWING MENU PROVIDES ACCESS TO 
PD HELP FACILITIES 


—TECTECECCCOCSCLCCLCCCCCCCCCCCSCSSCCSCLSSSS SSS SSE SECS SSS SSCS Cee ee. 
1. OVERVIEW OF PD HELP 
2. DYNEX HELP 
32 | SED EVOR “Hebe 
4. SIMULATION HELP 
5. TOOLS HELP 
6. TRANSLATOR HELP 
ee eS ele 


8. ViEW- HELP 


Choose an option: (ESC exits menu) 


Figure 3-9. Professional Dynamo Help 


Returning to the main menu, we now discuss Model Menu 
option # 3, Variable Manipulation. The objective of this 
selection is define the variables for the new user and allow 
manipulation of these variables in the Dynamica model. This 
is accomplished via the Dynex Model Interface, written for 
this thesis in Professional Dynamo's executive level 
programming language Dynex. 

The Dynex interface allows the user to view and 
manipulate variable values within the model. After selecting 
Variable Manipulation the user is presented Figure 3-10. The 


purpose of Figure 3-10 is simply to acknowledge to the user 


Lg 


that the selection has been activated and to prevent him from 
having to stare at a Dlank Ssercenweeoe a tole poser — 
seconds required to load the Dynex Interface. The local ia 
and date will be displayed if the computer in use has a 


battery powered clock/calendar. 


THE MODEL IS BEING LOADED ! 
Local Time 


Local Date 


Figure 3-10. Variable Manipulation 


After the Dynex Model Interface is loaded the user will 


be presented Figure 3-11. 
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THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
Maren. Joc 
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Press ENTER for a brief introduction to Model 
and Variable Manipulation. It is suggested 
reading for all new users of Dynamica. 

Experienced users will most likely want to 
skip directly to Model and Variable Manipulation. 
To do so type (n)o followed by Enter. 


Press Enter or (n)o tollowed by Enter 
Eo, Continue 


Figure 3-ll. Dynex interface Inenedmeean 


The introduction, shown in fue 8 totiecs 3-2, 3 oe 
3-14 and 3-15, is appropriate for new users of the Dynamica 
model, but may be skipped if desired by the experienced user. 
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The Dynex Model Interface then identifies, and defines 
the 18 model variables in Figures 3-16 and 3-17 which are 
available to the user to manipulate. The variables are 
divided into four categories: (1) Estimated Actual Project 
Size, (2) Variables Characteristic of the Organizational 
Environment, (3) Policy Variables, and (4) Model Control 


Variables. 
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WELCOME TO PROFESSIONAL DYNAMO AND THE DYNAMICA MODEL 
OF SOFTWARE PROJECT MANAGEMENT page l 
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INTRODUCTION 


Professional Dynamo is a high level model simula- 
tion language that has been used to create THE DYNAMICA 
MODEL OF SOFTWARE MANAGEMENT. You need to have no 
knowledge of how Professional Dynamo works to use the 
model. 

THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT, 
here after simply referred to as DYNAMICA, is a 
sophisticated simulation model designed to provide 
assistance in understanding and estimating the numerous 
and complex variables dynamically involved ina large 
software development project. 


Press Enter to Continue 


Figure 3-12. Dynex Interface page 1 
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Introduction page 2 
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To speed you on your way, a menu system has been 
developed to help you access the model which is 
written in PROFESSIONAL DYNAMO. This menu allows the 
user to customize the model to fit a Specific software 
project and conduct "what if" type experimentation. 
The user may access any of 18 variables or table 
values, from four categories. 


Press Enter to Continue 


Figure 3-13. Dynex Interface page 2 
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inlroduciaon page 3 
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When addressing a particular variable, the user 
may chose any value or use a previously defined value. 
Changes to variables from your last simulation are 
automatically stored with your simulation results if 
you chose to store your results. 

Your first step after you become familiar with the 
mechanics of the model will be to adjust all the perti- 
nent variables to customize the model to represent any 
specific software project you might have in mind. 
Otherwise, you may use the model "as is", to conduct 
your experimentation in the relationships of the 
variables. 


Press Enter to Continue 


Figure 3-14. Dynex Interface page 3 


OME 
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IMeRoauct lam page 4 
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The DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT has 
the potential for extensive online help facilities. 
Me@erentiy, only one aspect of the online help facility is 
employed, that being HELP on HELP. This has been done to 
demonstrate the available capability. To view the HELP on 
HELP, type (hjelp followed by a space and (h)elp again 
followed by striking the enter/return key. 


Press Enter to Continue 


Figure 3-15. Dynex Interface page 4 


23 


KKK KKK KK KKK KKK KK KKK KK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK K 


VARIABLE MANIPULATION page 5 
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The following 18 model variables of Dynamica are 
adjustable via the menn 
They are grouped in 4 categories for easy access. 


I. ESTIMATED ACTUAL PROJ EC TRS tae 


1. RJBDST 2 ee. eee Real Joo Size in BsSs 
II. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 
A. Prodwetryi ty 
2, “DSetlike. =... Delivered Source Instruction 
Per Task 
B. Quality 
32 TNEREK jee Error Rate Per 1000 Delivered 


source Instruction 
C. Staffing Variables 


4. HLREDY a <2220 ee eee Hiring Delay 
5. ASPMDY 3s eee Assimilation Delay 
6.0 »AVEMP TA. 4. ce eee Average Employment 
III. POLICY VARIABLES 
A. Estimation 
7s “UNDES ies: see Task Underestimation Factor 
8... TOTMD 1... cc) anes en Total Mandays 
9.. “TIDEV Is 2a a ees eee Time to Develop 


Press Enter To See the Remaining Variables 


Figure 3-16. Dynex Interface page 5 
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MODEL AND VARIABLE MANIPULATION page 6 
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Bb. Resource Allocation 
10. DEVPRT ....% of Effort Assumed Needed for 
Development 
11. TPRMQA....Fraction of Manpower Devoted to 
Quality Assurance 
ge 2 NWS lee ree le 4 LiPtetameunaerstarteang Factor 
NES ee BGA 8. A oe Willingness to Change the 
Workforce 
Moen ocafkfing 
ser dhass lo!) alih! sie. eae eae % of Experienced Employee 


Effort to Train a New Employee 
Por OMB Ss 6 ee Average Daily Manpower/Staff 
Expended on Project 
a MODEL CONTROL 
Gas ce CE ey NIN Poy sees, chats, gerne Max Length of Project 
LA SR Sy A SO Se save Period for Data 


Press Enter to See Variable Definitions 
or to Manipulate Variable Values. 


Figure 3-17. Dynex Interface page 6 
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The user may select to first look at a brief explanation 
of the variables, or go directly to variable manipulation as 
shown in Figure 3-18. To make a selection, type the number 
of the choice or choices, separating each number by a space 
or a comma. I£ no choice or an illegal choice is made, Dynex 


Will prompt the user to reenter all of his choices again. 
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MODEL AND VARIABLE DEFINITION AND MANIPULATION page 7 
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select one or more of the following eight topic areas. 
You may chose to first look at a brief explanation of the 
variables or go directly to variable manipulation. 


I. MODEL VARIABLE DEFINITIONS 
1. ESTIMATED ACTUAL PROJECT SIZE DEFINITION 
2. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT DEFINED 
3. POLICY VARIABLES DEL Tip 
4. MODEL CONTROL VARIABLES DEFINED 


II. MANIPULATION OF MODEL VARIABLES 
5. ESTIMATED ACTUAL PROUEC I Vaz 
6. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 


7. POLICY VARIABLES 
8. MODEL CONTROL VARIABLES 


Enter the number(s) of your selected choices. 
Separate each choice by a space or a comma. 


Figure 3-18. Dynex Interface page 7 


selection of choice # 1 fErom Figure 3-18, provides the 
user the definition of Estimated Actual Project Size Figure 


3-19. The user is automatically returned to the main Model 
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Menu after reviewing the last choice selected. Let us assume 
for the sake of this tour that the user has selected all 


eight choices. 
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Bo EMATED ACTUAL PROJECT SIZE DEFINITION page 8 
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Peemee Sone meN: OST. ee oe ee ee ee eee a RJBDSI 


The real size of the software project in delivered 
source instructions (DSI) with comments. The following 
definitions are from Boehm, 1981. 

Delivered. This term is generally meant to exclude 
nondelivered support software such as test drivers. 
However, if£ these are developed with the same care as 
delivered software, with their own reviews, test plans, 
documentation, etc., then they should be counted. 

pourece Instructions. This term includes all program 
instructions created by project personnel and processed 
into machine code by some combination of preprocessors, 
compilers, and assemblers. It excludes comment cards 
euaeunmoeditctied utility software. It includes job 
control language, format statements and data declarations. 
Instructions are defined as lines of code or card images. 
Thus, a line containing two or more source statements 
counts as one instruction; a five-line data declaration 
counts as £ive instructions. 


Press Enter to Continue 


Figure 3-19. Dynex Interface page 8 


selection # 2, Variables Characteristic of the 
Organizational Environment, presents the user the five 


Weetables definitions shown in Figures 3-20, 3-21, and 3-22. 


ay 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT DEFINITION page 9 
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DELIVERED SOURCE INSTRUCTIONS EER Tesh eee DSIPIK 

This parameter is set to the value of the nominal 
potential productivity in the organizational environ- 
ment being modeled. For example, if the nominal 
onotential productivity is 50 DSI/Man-Day then DSIPTK 
would be set to 50. 


ERROR RATE PER 1000 DELIVERED SOURCE 

INSTRUCTIONS ~CKDSD re TNERPK 
TNERPK is the number of errors committed on the 

average, per 1000 DSI, as the softwart .roject is being 

developed. It is not a single number but rather a table 

function. This allows the user to set different error 

rates at different stages of the project's lifecycle. 


Press Enter to Continue 


Figure 3-20. Dynex Interface page 9 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT DEFINITION page 10 
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HIRING DELAY sneer eer eee ree abti iseeD py 
HIREDY is the average delay time, in work days, 
incurred in adding new staff members to the project. 


ASSIMILATION DEGAY (0p ee ASIMDY 
ASIMDY is the average time needed to assimilate newly 

hired personnel into the project, measured in workdays. 

[It is the time required for orientation, institutionali- 

ZaCLONn ana Enaining: 


Press Enter to Continue 


Figure 3-21. Dynex Interface page 10 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT DEFINITION page ll 
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Serene OME NE ing as le es ve Sloe ee ee ee ee we AVEMPT 
AVEMPT is the average employment time of project team 
members, measured in working days. I[t is indirectly 


proportional with TURNOVER. For example, the smaller the 
AVEMPT the larger the turnover rate, and conversely, the 
smaller the turnover rate the higher the AVEMPT. 


Press Enter to Continue 


Figure 3-22. Dynex Interface page ll 


selection # 3, Policy Variables, presents the user the 
definitions of the seven policy variables shown in Figures 
Beemer 3-24, 3-25, 3-26, and 3-27. 

Selection of # 4, Model Control Variables, presents the 
user the definitions shown in Figure 3-28. The Dynex 
interface allows the user to adjust two model control 
variables. These variables provide the user control over 


two aspects of model operation. 


AS 
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POLICY VARIABLES DEFINITIONS page aia 
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TASK UNDER ESTIMATION EAC OR eee UNDEST 
Undersizing is a large problem in project management. 

This variable allows the to experiment with different 

values of underestimates. Thus to simulate a situation 

where the project size is initially underestimated by 

25%, this variable would be set to 0.25. 


TOTAL MAN DAYS~.... 2.223255 332 ee TOTMD1 

TOTMD1 is the man-day estimate produced at the start 
of the project, for design, coding and system testing of 
the project. 


TIME TO DEVELOP cic TDEVe 
TDEV1 represents the estimated time, measured in work 
days, for the design, coding and testing stages of the 
project, produced at the start of the project. For example, 
if the initial project duration estimate was 16 months, 
TDEV1 would be equal to (16 x 20) or 320 working days. 


Press Enter to Continue 


Figure 3-23. Dynex Interface page 12 
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POLICY VARIABLES DEFINITIONS page 13 
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peereece PORT ASSUMED NEEDED FOR DEVELOPMENT .......... DEVPRT 

This variable is used to allocate the projected total 
budget, measured in Man-Days, for the development (which 
includes design and coding) and testing phases. For 
example, if it is decided that 80% of the total Man-Days 
would be allocated to development and 20% to testing, then 
DEVPRT would be set to 0.80. 


freee l LON OF MANPOWER DEVOTED TO QUALITY ASSURANCE ....TPFMQA 
TPFMQA is the percent of development effort allocated 
in the project's plan for QA activities during the design 
and coding stages. It is not a single number but rather a 
table function that allows the user to change the number 
of Man-Days allocated to QA at different stages in the 
project lifecycle. A value of 0.20 at some point in the 
project would indicate that at this point, 20% of the 
Man-Day budget is allocated to QA. 


Press Enter to Continue 


Figure 3-24. Dynex Interface page 13 
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POLECY VARIABLES DEFINITIONS page 14 
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emmem i UONDERSTAPFING FACTOR .......02 00 be ee ce ewe wee TNDUST 
The project's average staffing level is equal to the 
MeoJeCeE’s total number of Man-Days divided by the project's 
scheduled duration. Typically, the project will start with 
a small core team which grows in size. This variable 
specifies the size of the starting group. Thus a value of 
0.5 indicates that the startup team is half the size of the 
average staff size. 


Press Enter To Continue 


Figure 3-25. Dynex Interface page 14 
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POLICY VARIABLES DEFINITIONS page 15 
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WILLINGNESS TO GHANGE THE WORKVORGE (2 WL 1 
On deciding upon a "Workforce" level desired, project 
managers typically consider a number of factors. One 


important factor is the project's scheduled completion date. 
As part of the planning function, management determines the 
workforce level that it believes is necessary to complete the 
project on schedule. In addition to this factor, considera- 
tion is also given to the stability of the workforce. ~ Das? 
before adding new project members, management tries to 
contemplate the project employment for new members. 
Different organizations weigh this factor differently. In 
general, the relative weighing between the desire for work- 
force stability on one hand and the desire to complete the 
project on time, on the other, is not static, but changes 
dynamically throughout the lifecycle of the project. For 
example, toward the end of the project there is typically 
considerable reluctance to bring in new people, even if the 
project is behind schedule. I[t would take too much time and 
effort ( relative to the time and effort that are remaining) 
to acquaint new people with the mechanics of the project, 
integrate them into the project team and train them in the 
necessary technical areas. 


Press Enter for More Information of WCWF1 


om 
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WCWF1 DEFINITION CONTINUE page 16 
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These managerial considerations are operational in the 
model as follows: WORKFORCE LEVEL NEEDED = (INDICATED 
WORKFORCE LEVEL) * (WCWF) + (CURRENT WORKFORCE) * (1-WCWF) 

The Weighting Factor (WCWF) is termed Willingness to 
Change the Workforce. 


In the early stages of the project when "Time Remaining" 
is generally much larger than the sum of "Hiring Delay" and 
the "Average Assimilation Delay" WCWF would be equal to l. 
When WCWF is = 1, the "Workforce Level Needed" in the above 
equation would simply be equal to the "Indicated Workforce 
Level," i.e., management would be adjusting its workforce 
size to the level it feels is needed to finish on schedule. 
The "Indicated Workforce Level" can be determined by dividing 
the amount of effort that management perceives is still 
remaining (in Man-Days) by the time remaining to complete the 
project in days. 

When the "Time Remaining" decreases, ASSIMILATION DELAY 
(ASIMDY) could be set to equal exactly 0. The "Workforce 
Level Needed" in the equation would thus be equal to the 
"Current Workforce" i.e., management attempts to maintain 
the projects workforce at its current level, and make 
adjustments to the schedule instead. 


Press Enter to Continue 


Figure 3-26. Dynex Interface page 16 
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POLICY VARIABLE DEFINITIONS page a 
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TRAINERS PER NEW EMPEO YE eee ee TRPHNR 
In most organizations, training of new employees is 
carried out by the more experienced employees. This variable 

defines the fraction of an experienced staff member's time 
that is devoted to train new hirees. For example, a value of 
0.2 indicates that on the average each new employee consumes 
20% of an experienced employee's time for the duration of 

the assimilation delay. 


AVERAGE DAILY MANPOWER PER STAFF EXPENDED 
ON PROJECT 5 ie ech eee ee cree ae a ADMPPS 
Project members are often only assigned part-time to 
a project. ADMPPS defines the % of time that the team 
members devote, on an average to the particular project being 
Simulated. For example, if staff members tend to divide 
their time equally between two projects, i.e., half of their 
Cime is spent on project A and the other half iS Spent on 
project B, then ADMPPS would be = 0.5. 


Press Enter to Continue 


Figure 3-27. Dynex Interface page 17 
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MODEL CONTROL VARIABLE DEFINITIONS page 18 
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mero lt Or PROJECT i ee a te ee ee MAXLEN 
tims model control ™vyariable is useful in controlling 
the simulations. [It precludes the model from continuing a 


simulation beyond a predetermined length, e.g., 1000 days. 


eee COD FOR DATA <2. cw st et ee ew ee eee ee SAVPER 
This model control variable allows the user to adjust 
the models save period for data for later viewing. For 


example, if the user sets the SAVPER = 1, the model will save 
all variable values on a daily basis, this data would be 
available for the user to examine and plot at the end of a 
Simulation. A SAVPER of 10, saves values every 10 days. This 
provides the user with a trade off between the time required 
for a simulation and the level of detail of the results. 


Press Enter to Continue 


Figure 3-28. Dynex Interface page 18 


selections # 4-8 provide the user the opportunity to 
manipulate the variables defined by the first four 
selections. When the user selects any category of model 
manipulation, the current value of each variable is displayed 
as shown in Figures 3-29 - 3-43. To change a variable enter 
the value desired and depress enter/return. If the user 
wishes to use the current value simply press enter/return. 
In either case the next variable to be manipulated will be 
displayed or the user will be automatically returned to the 


Model Menu if no other variables have been selected. 


Se 
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ESTIMATED ACTUAL PROJECT SIZE VARIABLE MANIPULATION page 19 


KKK KKK KK KOK KKK KKK KO Km mK KK Kk Ok mm RK KK RK KKK KKK KK 


REAL JOB SIZE IN DELIVERED SOUKGE INS MeCN. eee RJEBBS 
Enter a new value for REAL JOB SIGE IN DELIVERED SOURCE 
INSTRUCTIONS or press enter to use the preset value. The 
preset value is written using a form of scientific notation 
where e3 represents x 10 to the third power. You do not have 
to enter a value in that format but be aware that the model 
will represent numbers in that format. 
24.4e3 


Figure 3-29. Dynex Interface page 19 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT MANIPULATION page 20 
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Enter a new value for DELIVERED SOURCE INSTRUCTIONS PER 
TASK or press enter to use the preset value. 
40.0 


Figure 3-30. Dynex Interface page 20 


Although most variables are a single value, some of the 
variables have more then one value and are referred to as 
table values. Examples of table values are shown in Figures 
3-31, 3-31.1, 3-36, 3-38 and@3—-40 9b iguees 32s) andue saan 
show that the user enters all six table values, separating 
each value by either a space or comma, before depressing 
enter/return. Table values generally represent variables 
whose values change over time. Dynex will prompt the user to 
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respond again if an incorrect number of variables are 
entered. The method of entering multiple variables is the 
Same as selecting multiple choices from a Dynex Menu, each 


choice must be separated by a space or a comma. 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT MANIPULATION page 21 
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Enter a new value for ERROR RATE PER 1000 DELIVERED 
SOURCE INSTRUCTIONS or press enter to use the preset table 
values. 


i 2 S 4 = 6 


Figure 3-31. Dynex Interface page 2l 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT MANIPULATION page 21 
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Enter a new value for ERROR RATE PER 1000 DELIVERED 
BeURCE INSTRUCTIONS or press enter to use the preset table 
values. 


1 Z 3 4 5 6 
Memeoeez2. 9 = 20.75 15.25 13.1 12.0 


Figure 3-31.1. Dynex Interface page 21 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT MANIPULATION pages 
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Enter a new value for HIRING DELAY or press enter to use 
the preset value. 
3020 


Figure 3-32. Dynex Interface page 22 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT MANIPULATION page 23 
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Enter a new value for ASSIMILATION DELAY or press enter 
to uSe the preset value. 


20-0 


Figure 3-33. Dynex Interface page 23 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 
ENVIRONMENT MANIPULATION page 24 
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Enter a new value for AVERAGE EMPLOYMENT or press enter 
to use the preset value. 


1000 


Figure 3-34. Dynex Interface page 24 


38 


The user is provided two methods of entering values for 
the variables Total Man-Days and Time to Develop as shown in 
Figure 3-35. The values may be entered directly, similar to 
the other variables or the user may elect to have the model 


compute both values using COCOMO. 
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POLICY VARIABLE MANIPULATION page 295 
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For assigning values to TOTAL MANDAYS and TIME TO 


DEVELOP the user may either: 
1. Calculate the two values external to the model 
and input them directly at the prompt below. 


OR 


2. Allow the model to calculate the two values 
imicentaliey Wri a1ng COCOMO by “imputing 0 for 
each of the 2 variables at the COCOMO 
PROMPT. 

meorDl lili 
TDEV1 701.0 


COCOMO PROMPT: 

Enter 1 at the next two prompts to allow COCOMO to compute 
TOTMD1 AND TDEV1. OR enter 0 to use your own values input 
above. 


Press Enter to Continue 


Figure 3-35. Dynex Interface page 25 
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POLICY VARIABLES MANIPULATION page 26 
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Enter a new set of table values for the TASK UNDER 
ESTIMATION FACTOR or press enter to use the preset value. 


1 Z t 4 3, 6 Z 82-495 ele Thal 


Figure 3-36. Dynex Interface page 26 
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POLICY VARIABLES MANIPULATION page 27 


KEK KKK KK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK 


Enter a new value for % OF EFFORT ASSUMED NEEDED FOR 
DEVELOPMENT or press enter to use the preset value. 


a2 


Figure 3-37. Dynex Interface page 27 
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POLICY VARIABLES MANIPULATION page Ze 
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Enter a new value for FRACTION OF MANPOWER DEVOTED TO 
QUALITY ASSURANCE or press enter to use the preset value. 


i Z é 4 o 6 7 8 2 10 ih 


Figure 3-38. Dynex Interface page 28 


40 


KKK KKK KK KKK KKK KK KKK KKK KEKE KKK KKK KKK KKK KKK KKK KR KEK KKK KKK KKK KKK 


POLICY VARIABLES MANIPULATION page 29 
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Enter a new value for INITIAL UNDERSTAFFING FACTOR or 
press enter to use the preset value. 
.4 


Figure 3-39. Dynex Interface page 29 
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POLICY VARIABLES MANIPULATION page 30 
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Enter a new value for WILLINGNESS TO CHANGE THE WORKFORCE 
Or press enter to use the preset table values. 


1 2 3 4 5 6 7 8 9 10 eZee 14 


Figure 3-40. Dynex Interface page 30. 
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POLICY VARIABLES MANIPULATION page 31 
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Enter a new value for PERCENT OF EXPERIENCED EMPLOYEE 
EFFORT TO TRAIN A NEW EMPLOYEE or press enter to use the 
preset value. 


m2) 


Figure 3-41. Dynex Interface page 31 
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POLICY VARIABLES MANIPULATION page 32 
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Enter a new value for AVERAGE DAILY MANPOWER PER STAFF 
EXPENDED ON PROJECT TO TRAIN A NEW EMPLOYEE or press enter 
to use the preset value. 


=) 


Figure 3-42. Dynex Interface page 32 
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MODEL CONTROL VARIABLE MANIPULATIONS page 33 
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Enter a new value for MAX LENGTH OF PROJECT or press 
enter to use the preset value. 


1000 


Figure 3-43. Dynex Interface page 33 
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MODEL CONTROL VARIABLE MANIPULATIONS page 34 
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Enter a new value for SAVE PERIOD FOR DATA or press 
enter to use the preset value. 


10 


Figure 3-44. Dynex Interface page 34 
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Figure 3-44 is the last screen in the Dynex Model 
Interface. The user is automatically returned to the main 
Model Menu. 

After returning to the main Model Menu, selection # 4, 
Run Simulation, allows the user to run a model simulation 
with the variable values selected via main Model Menu 
feection # 3. After selecting Run Simulation the user views 
Figure 3-45 while the Dynamica model is prepared for 


Smuatation. 


fie MODEL ISsBR ING PREPARED FOR A SIMULATION ! 


Local Time 
Local Date 


Paiguie 3-45. .kUun Simulation 


After loading the Dynamica model automatically runs the 
Simulation. Upon conclusion of the simulation run, the user 
is automatically returned to the main Model Menu. 

selection of Model Menu # 5, To Store and Print Results, 


provides the user access to the submenu shown in Figure 3-46. 
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TO STORE AND PRINT RESULTS 
THIS MENU ALLOWS THE USER TO STORE AND PRINT 
SIMULATION RESULTS 
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1. sSTORING STATIS@RCS 
2. PLOTTING RESULTS 
3.  x—PRINTINGS YOUR sR ECULS 


Choose an option: (ESC exits menu) 


Figure 3-46. To Store and Print Results 


The user is provided three submenu selections in Figure 
3-46: (1) Storing Statistics, (2) Plotting Kesults andwee 
Printing Your Results. 

If # 1, Storing Statistics is selected, the model 
collects statistics from the previous simulation and places 
them ina predefined report format. This report format may 
be adjusted utilizing Professional Dynamo, to suit the user's 
needs. This report may then be stored under a file and ina 
directory of the user's choice for future reference Figure 
3-47. Any changes to variables from the previous simulation 


run will be appended and stored at the bottom of the report. 
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YOUR RESULTS ARE BEING STORED IN THE PROPER FORMAT ! 


Local Time 
Local Date 


pmeeot ENTER THE FILE NAME YOU DESIRE FOR THIS REPORT. 

IT IS SUGGESTED THAT YOU NAME YOUR FILES IN A MANNER 

WHICH WILL ALLOW THE MAXIMUM BENEFITS OF THE DOS 

WILDCARD ( * ) FEATURE WHEN MANIPULATING YOUR FILES. 

PAAME Beech ROUBCT. =) 

NOTE: CHANGES MADE TO VARIABLES ARE APPENDED TO THIS 
FILE. FOR EXAMPLE IF HIRING DELAY WAS CHANGED 
FROM 30 TO 40, THAT INFORMATION WOULD BE STORED 
Pita Ne Ol THe REPORT. 


ENTER THE FULL PATH NAME OF THE DIRECTORY WHERE 
Ve WOU GEKE TH RESUBTS STORED. 


Figures? 47 2s SeOring otaltistics 


At the conclusion of Storing Statistics, the user is 
automatically returned to Figure 3-46. 

Selecting # 2, Plotting Results, provides the user access 
to the submenu shown in Figure 3-48. 


KEKE KKK KKK KKK KEKE KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK 


PLOTTING RESULTS 
THE FOLLOWING MENU ALLOWS THE USER TO VIEW AND 
SAVE 4 PREDEFINED PLOTS 


RKEK KEK KERR KEKE KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK 


Pe OVERVIEWS PLOTTING FUNCTIONS 


Zope ee 
Se, =PILOE 2 
4. PLOT 3 
5. PLOT 4 
Choose an option: (ESC exits menu) 


Figure 3-48. Plotting Results 
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There are five selections available in Figure 3-48. 
Selection # 1, Overview of the Plotting Functions, provides 
the user an introduction to the origin and purpose of a set 
of four predefined plots, selections # 2-5 Figure 3-49. 
Selecting any of the predefined plots presents the user a 
list of the variables plotted by that selection Figures 3-50, 
3-51, 3-52 and 3-53. The variables ane then olotred aneciwiae 


user is given the option Gf printing, tne splot Livse desivee 


KKK KKK KR KKK KK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KK KKK 


OVERVIEW OF PLOTTING FUNCTIONS 


KKK KKK KK KR RK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KK 


The Dynamica model can create plots of preselected 
variables. Each Plotting function, contains a list o£ Ehe 
variables plotted by that menu selection. Viewing a plot is 
Simply a matter of selecting the number of the plot desired. 
These plots may be printed using the print function of the 
included menu. 


HIT ANY KEY Jes cen rue 


Figure 3-49. Overview of Porting incelon. 
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PLOT 2 


KEK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KK 


PLOT 1 GRAPHS THE FOLLOWING VARIABLES: 


eee merece. se. . . 2 BOTIMATED SCHEDULE IN DAYS 
Mee. =. st lel Ul) 6 PERCEIVED PROJECT SI@E IN TASKS 
wea. . . . » « « ESTIMATED PROJECT COST IN MAN-DAYS 
Mee. el CCC CCC CU elCUlwtlCU eC TALL WORKFORCE PEOPLE 
mia. . . wl le .hl.CUllU ee CUMULATIVE MAN-DAYS EXPENDED 


ieee rOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)O. 


Figure 3-50. Plot l 


KKK KKK KKK KKK KR KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK 


PLOT 2 


KRKEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK 


PrROL, 4 OULTCK REV@eiW OF THE VARIABLES BEING 
peat TED: 


Serve sll Ue CUMULATIVE TASKS DEVELOPED 
oe ees a. eee. «| «6©6WCUMULATIVE TASKS TESTED 
CUMMD eee a CUMULATIVE MAN-DAYS EXPENDED 
Peesocmee. 2. . . » + PERCEIVED PROJECT SIZE IN TASKS 
POBVRGC 9. »| « . . » ESTIMATED % DEVELOPMENT COMPLETE 


PerOUTRAVE AN EGA CARD TYPE (YJES IF NOT TYPE (N)OQ. 


Proure s-Slve pelee 2 
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PLOT 3 


WRK KK KKK WK KOK KOK KKK AAW KWOK KR KOK WOK KK KOK OK WK KOK RK KOK KR OK OK WOK ROKK KOK KK 


FIRST, A QUICK REVIEW OF THE VARIABLES BEING PLOTTED: 


TOTWE «408 oe mee) RR Se  .  e  TOT Bi WO Ree 

FRWEFEX . . . . . . . . . . FRACTION OF WORKFORCE THA Tie 
EXPERIENCED 

SDVPRD . i i ee i esis CO) ele 

COMMOH . . 2s . 6 «© » 3 « = ee COMMUNT SATO ie) aici aiEa mn 


IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (Noes 


Figure 3-52,.2 hoi 


wm KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KEKE KEK KKK KKK KKK KK 


PLOT 4 


RR KKK KKH KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK 


FIRST, A QUICK REVIEW OF THE VARIABLES BEING PLOTIGGE 


APMPDJ .. .. . . . . ACTUAL FRACTION OF A MAN-DAY er 
PROJECT 
JBSQ2MD . 2 2 . 89% oe a PERGE IY DG A Ere Cage een 
MAN-DAYS 
PJBSG «6 . «6 4 eRe . . PERCEIVED JOB S146 TEN ieee 
PMDSHR . . . . =. « % . PERCEIVED SHORTAGE IN UAN-DAws 


IF YOU HAVE AN EGA CARD TYPE (Y)ES if NOT TYPE hee 


Figure 3-53. eePiloer4 
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When the user is finished with the plotting functions, 
pressing the escape key returns Figure 3-46 to the screen. 
The last option available to the user in Figure 3-46 is 
selection # 3, Printing Your Results. Selection of choice # 
feeeerinting Your Results, allows the user to print any files 
to an attached printer. The user is asked to type only the 
name of the file to be printed. The use of DOS wildcard 
symbols is suggested to aid in printing large numbers of 
files at a time Figure 3-54. The DOS command graphics has 
been entered for the user, to allow the use of bit mapped 
Smeaphics £or suitably configured printers. 
PLEASE ENTER THE FULL NAME OF THE FILE YOU WOULD LIKE 
PRINTED. YOU MAY USE DOS WILDCARD ( * ) SYMBOLS FOR 
PRINTING MORE THEN ONE FILE AT A TIME. 


STAD RWi oh PER ASE TYPE (QO)) TO QUIT. 
EXAMPLE: (MONDAY. *) 


Pugugwe 3-54." Printing Your Results 


Typing (Q)uit returns the user to Figure 3-46. To return to 
the main Model Menu press escape. 

selection of # 6, from the Model Menu, View Results and 
Print Graphs, allows the user to view statistical results on 
any or all cf 46 performance parameters measured for each 
Simulation or create graphs for any of 30 variables. After 


selecting # 6, the user is queried as to the graphics card 
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capability of the computer in use Figure 3-55. This allows 
graphs to be displayed and printed at the maximum resolution 


for the equipment in use. 


YOUR RESULTS ARE BEING PREPARED FOR VIEWING ! 
IF YOU HAVE AN EGA GRAPHICS CARD TYPE (Cy) 
FOLLOWED BY ENTER. 


IF YOU DO NOT HAVE AN EGA CARD TYPE (n) 
FOLLOWED BY ENTER. 


Figure 3-55. View Results and Print Graphs 


The user may return to the main Model Menu by pressing escape 
or quit at the prompt after making any number of graphs 
desired. 

The final selection of the main Model Menu is # 7, Exit 
To Dos. This selection simply returns the user to the DOS 
prompt in the directory where the user interface is stored. 
To return to the Model Menu, type (menu) and depress 


enter/return. 
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i Se oN ere Lee LURE 


PeeoveERVIEW OF THE SYSTEM ARCHITECTURE 

A system architecture overview of the user interface 
created in this thesis is depicted in Figure 4-1. There are 
three interrelated subsystems represented at this level, the 
Model Menu, the Dynamica model and the Dynex Model Interface. 


MODEL MENU 


DYNAMICA MODEL DYNEX MODEL INTERFACE 


: al —— 


Figure 4-1. Overview of System Architecture 











Mme oilmulation 
Store and Print Results 
View Results and Print Graphs 





The heart of the system is the Dynamica model. The 
Dynamica model, written in Professional Dynamo, allows the 
dynamic processing of variables from management-type 
functions and software production type activities. The Model 


menu allows the inexperienced modeler, access to the Dynamica 
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model directly to perform the numerous model functions 
available through Professional Dynamo (e.g., run simulations, 
store and plot statistics and to view simulation results). 
The Dynex Model Interface is unique in that it allows the 
user to interact with the Dynamica model (e.g., changing the 
values of variables and constants). The Model Menu accesses 
the Dynamica model via the Dynex Model Interface to allow the 


user to manipulate variable values within the Dynamica model. 


B. MODEL MENU 

The Model Menu is a shell which allows the logical 
organization by function, of 24 separate batch files. 

The Model Menu utilizes the nesting of submenus to enhance 
the functional organization of the menu. For example, if # 2 
Help Facilities is selected from the main Model Menu, the 
user iS presented a submenu of three help related topics. 
selection of # 3, Professional Dynamo Help, from this second 
menu presents the user with a submenu of eight Professional 
Dynamo Help topics to choose from. 

The Model Menu has five functionally related submenus, 
Introduction to the Model Menu, Help Facilities, Professional 
Dynamo Help, To Store and Print Resules 7 and.) horemnag 
Results. Typing the number of any menu selection initiates a 
batch file which either performs a function (e.g., selection 
of # 2, Run Simulation, runs a model simulation ) or produces 
a submenu with additional choices. The 24 batch files are 
separate from the menu shell and are easily modified. The 
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submenus are part of the shell structure as listed in 
Appendix B and require the use of the EXECMAKE function of 
EBL to be modified. 

The name of the batch file which initiates the menu 
program is menu.bat. It performs the following functions: 
@meecurn echo off, (2) enters the DOS command graphics, (3) 
loads the BATALLF command file from EBL and (4) brings the 
main menu, titled MODEL MENU to the display. The BATALLF 
command file contains the Extended Batch Language program and 
aiebeexternal EBL function commands (Ref. 8:pp. 2-5]. 

The Model Menu was written using the EXECMAKE function of 
Extended Batch Language, Version 3 (Ref. 8:p. 10]. EBL is a 
high level, command programming language which can be used in 
replacement of, or in conjunction with DOS batch files [Ref. 
9:p. 2). EBL provides enhanced string handling 
characteristics, superior control structures and screen 


control relative to standard DOS batch files [Ref. 9:pp. 2- 


G)). 

The 24 batch files have been divided into three 
categories based on their functions in the Model Menu. They 
are discussed separately in the following three sections. A 


program listing of the batch files has been provided in 
Appendix C. 
1. Batch File Explanations of Model Functions 
Fourteen of the twenty-four batch files called by 


the Model Menu are script files which provide the user 
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instructions or background information on the use of the 
Dynamica model and the user interface Figure 4-2. All of 
these script files, except for Professional Dynamo Help were 
created for this thesis using the advanced string handling 
characteristics of EBL. 

Figure 4-2 depicts the batch files that provide the 


explanation screens of menu options discussed in Chapter III. 


MODEL MENU FILES 
[Introduettoumreomene 
Model Menu 

Purpose of the Model 

Menu Purpose.bat 


Hardware/Software 
Requirements Hardwar.bat 


Suggestions for 


Using the Menu Suggest.bat 


Figure 4-2. Batch File Explanations of Model Menu Functions 


Ze Help Batch Files 


Professional Dynamo Help provides the user access to 
the help facilities provided within Professional Dynamo 
(Ref. 10]. These help facilities provide valuable 
information to the experienced model builder on the operation 
of the model. The batch files which access the eight 
separate Professional Dynamo help files are listed in Figure 
4-3. Users view these eight separate help files via the 


public domain software program, List.com. List.com allows 
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the user to page or scroll through the files, forwards or 


backwards, after they have been accessed from the Model Menu 


(Ref. 11). 


MODEL MENU 
Professional Dynamo 
Help 
Overview of PD Help 
Dynex Help 
Editor Help 
Simulation Help 
Tools Help 
Translator Help 
Utilities Help 
View Help 

To Store and Print Results 

Plotting Results 
Over of Plotting 
Puncitons 

Help Facilities 
Over of Help 


Facilities 


Online Model Help 
Information 


Figure 4-3. 


PD. bat 
Dynex. bat 
Editor.bat 
Simhelp.bat 
Tools.bat 
Transhel.bat 
Utilhel.bat 


Viewhel.bat 


Overview. bat 


Over.bat 


Help.bat 


Help Batch File 


Se Batch Files for Printing Simulation Results 


As a convenience to the user, 


a file printing 


facility was cv~eated and included in the menu system to allow 


the user to produce hard copies of simulation results with an 


attached printer. The print.bat file see Figure 4-4 was 


written using DOS and EBL commands. A public domain software 
program, SDIR26.com, is utilized in the batch file to produce 


the directory display the user views [Ref. 12]. 


MODEL MENU PRINTING FILES 
Printing = Your Print.bat prints files using 
Results DOS commands 


Figure 4-4. Model Menu - Printing Files 


C. THE DYNAMICA MODEL 

The Dynamica model, was originally written by Dr. Tarek 
K. Abdel-Hamid, while at the Massachusetts Institute of 
Technology [{Ref. 13]. The Model Menu accesses the Dynamica 
model directly via the seven separate batch files listed in 
Figure 4-5, or indirectly via the Dynex Model Interface. 
The seven batch files shown in Figure 4-5, call commands 
within the Dynamica model. The Dynex Model Interface is 
explained in part D. of this chapter. 

Explanations of the Dynamica model commands shown in 
Figure 4-5, which would be useful to the experienced model 
builder, can be found in the Professional Dynamo Help 


Screens: 
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MODEL MENU PROFESSIONAL DYNAMOQ 


COMMANDS 
Run Simulations Runsim.bat SMLteprhoject -—go = 
Store and Print 
Results 
eeoring Statistics Simulat.bat project stats 
Plotting Results 
HonceELons 
Prot 1 Plotl.bat Mepuproyvece pilot] 
Brot 2 PlGeZ. bac rep project plotd 
Plot 3 Plot3.bat Repwpaovecte plots 
Plot 4 Plot4.bat rep project plot4 
View Results and Print 
Graphs Viewsim.bat view project.rsl 


Figure 4-5. Model Menu - Dynamica Model 


Peet DYNEX MODEL INTERFACE 

The Dynex Model Interface, was written for this thesis in 
Dynex, the high level model interface language of 
Professional Dynamo. Dynex was specifically designed to 
allow the experienced model builer to create an environment 
for model operation specifically suited for a certain skill 
level of user. Mose often, the model builder creates a 
"game" type of format, which allows the model to be used by 
inexperienced modelers. Dynex allows the model builder to 
set up files which execute Professional Dynamo commands, 
transparently to the user [Ref. 10:p. 181]. 

When Dynex files are invoked, model functions are 
performed automatically for the user. The experienced model 


builder can use Dynex to make a model available for users in 
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a structured and easily understandable framework [Ref. 10:p. 
181). He can provide information on model operation to a 
user, at a level commensurate with the user's abilities and 
experience level. 

Dynex is unique in that it allows the user to access the 
variables within a simulation model written in Professional 
Dynamo. In contrast, the batch files written for the user 
interface, perform "house-keeping details", and execute 
numerous commands for the convenience of the user. 

The Model Menu system accesses Dynex Model Interface via 


the single batch file shown in Figure 4-6. 


MODEL MENU NTERFACE 
Variable Variabl.bat project dynex 
Manipulation 


Figure 4-6. Model Menu - Dynex Model Interface 


After the user has completed using the Dynex Model 
Interface, he/she will be returned automatically to the main 


Model Menu. 
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V. CONCLUSIONS 


A. ACCOMPLISHMENTS 

The primary objective of this thesis was the development 
of a user interface for the Dynamica Model of Software 
Project Management which would: (1) make the Dynamica model 
easier to use, (2) improve the model's facilities for 
accessing, storing and reviewing simulation results and (3) 
improve the current method of variable manipulation. 

A menu system was created to outline and provide easy 
access to the major functions of the Dynamica model. A help 
system was provided along with numerous script files 
explaining model functions. Facilities were provided to 
allow the user to store, plot or print simulation results. 
Viewing simulation results was also made easier. Most of 
these improvements were done with the use of DOS and EBL 
batch files in conjunction with the model menu. The user is 
able to select a desired function using the Model Menu system 
and have the batch files perform the low level work. 

A model interface was programmed in Dynex to control and 
improve the access and manipulation of varaibles in the 


Dynamica model. 


B. LESSONS LEARNED 
The user interface for the Dynamica model was designed 
by an iterative process of prototyping and testing. This 
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method of design was successful but time consuming. The 
testing of the prototype systems often revealed flaws that 
otherwise were not readily apparent. For example, early 
prototypes did not provide the user with an adequate amount 
of feedback after menu selections. It was recognized that 
periods of "dead time" on the users display, while files were 
loaded or DOS commands were being executed, gave the 
impression to the user that the interface was not functioning 
properly. Since these commands and DOS functions coule rot 
be sped up, the dead periods were replaced with screens 

which provided the user assurances that the model was 
functioning normally. 

secondly, to offset the time consuming process of 
prototyping a system design of this nature, the designer is 
best served by creating and experimenting with only the shell 
of the proposed system. Only after the design of the shell 
has met with approval via testing should the designer begin 
Writing the modules called by the shell. 

Originally, the 24 batch files were part of the Model 
Menu shell created with the EXECMAKE facility of EBL. Editing 
of any batch file required that the Model Menu shell be 
Similarly adjusted, a time consuming process. This editing 
problem was resolved by having the Model Menu contain only 
Calls 6 the batten filles: The 24 separate batch files can 


now be edited individually. 
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Lastly, early prototypes of the Dynex Model Interface 
were found to include more information for the user then was 
suitable for that format. Much of this information, belonged 


more appropriately ina user or reference manual format. 


eee hUTURE DIRECTION 

There are many areas available for future research. These 
areas fall under two general categories, the refining of the 
current interface, and expanding the capabilities of the 
interface. 

There are many areas in the current interface that need 
refinement or expanding. Keeping in mind that the major goal 
of the Dynamica model is for users to develope a better 
understanding of the dynamic behavior of software project 
variables, improved methods of storing and analyzing the 
results of numerous simulations are needed. One suggestion 
is to use the Professional Dynamo, Report Generator 
Facilities to plot the results of variables from multiple 
Simulations. Another is to provide the user the capability 
memsave Plots or graphs in £iles of the user's choosing. 

The current system also needs the development of a more 
complete user's manual. This user's manual should provide 
detailed information on the Dynamica model as well as the 
design of the user interface. Its goal should be to help 
users learn how to manipulate the Dynamica model to best suit 


their own needs. To do this would require an extensive, 
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detailed manual with numerous examples. It would require the 
compilation of reference information from Professional 
Dynamo, EBL, and the Dynamica model. 

User comments should also be collected and studied to 
determine problem areas of the interface in itS Current form. 
Users should be queried as to what other variables or 
capabilities they would like made available. 

Dynex also has the capability for the creation of 
extensiv2 online help facilities. These help facilities are 
available when the user is operating within the Dynex model 
interface. Suggested topic areas for this help would include 
inputing variable values (for both single value variables and 
table variables), saving and printing simulation results 
(plotting, graphs and report generation) and the explanation 
of Dynex error codes. 

Finally, a more ambitious suggestion would be to include 
the Intermediate Constructive Cost Model (COCOMO) in the user 
interface (Ref. 14:p. 58]. COCOMO is a generic name for a 
hiearchy of software cost-estimation models. The intermediate 
level of COCOMO uses 15 cost drivers or predictors to 
estimate software development effort. Research for this 
thesis, would suggest two possible implementation schemes. 
First and most preferable, would be to incorporate the COCOMO 
variables and their equations into the Dynamica model using 
Professional Dynamo. These variables could then be accessed 


via the Dynex Model Interface. A second option would be to 
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write a C or BASIC program which would accept variable values 
and perform the required COCOMO calculations. This program 
would be called by the Model Menu, via a DOS batch file. 

This DOS batch file would also return the variables 
calculated by COCOMO to the Dynamica model. The first option 
would be preferred for its speed, ease of operation, and the 
increased flexibility provided the system designer and the 
user. Using eigher option mentioned, would allow the user to 
refine a basic COCOMO development effort estimate. 

Dynex allows the use of arithmetic expressions of 
parameter names and numbers within the display o£ text. An 
experienced model builder could therefore create a "learning 
game" where user predictions could be matched against the 
quantitatively produced COCOMO estimations. The user could 
then select the values of his choice for use in the Dynamica 
model, and be provided rapid feedback on the consequences by 


running a model simulation. 
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APPENDIX A 


BATCH FILES PROGRAM LISTING 


BAT CLS 

HO) 5 (O19) 2 

BAT REM FILE NAME: VARIABL. BAT 
BAT BEGTYPE 

\OA 


THE MODEL is BEING boar, 


END 

BAL TY Pr. ah ei ce) 
BAT TYPE DATE() 
DYNEX PROJECT 


BAT CLS 

ECHO Oi5n 

BAT REM FILE NAME: RUNSIM. BAT 
BA Cis 

BAT BEGTYPE 

\OA 


THE MODEL IS BEING PREPARED FOR A SIMULATION ! 


END 
BA Yee eG e. 3) 


BAT TYPE DATE() 
SMLT PROJECT -GO = 
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Ee! CLS 


emo OFF 

BAT REM FILE NAME: VIEWSIM. BAT 

eel CLS 

Bet BEGTYPE 

\OA 

YOUR RESULTS ARE BEING PREPARED FOR VIEWING ! 

IF YOU HAVE AN EGA GRAPHICS CARD TYPE (Cy) 
FOLLOWED BY ENTER. 
IF YOU DO NOT HAVE AN EGA CARD TYPE (n) 
FOLLOWED BY ENTER. 

END 


BAT INKEY %0 
BAT IF ¥Y = %0 THEN GOTO EGA 
Bet ELSE GOTO OTHER 


:EGA 

VIEW PROJECT.RSL -PLM 6 
Ee. CLS 

Bet EXIT 


> OTHER 

VIEW PROJECT. RSL 

BAT EXIT 

fen OFF 

BAT REM FILE NAME: PURPOSE. BAT 


KKK KKK KKK KKK KKK KKK KR KKK KKK KK KK KKK KKK KEK KKK KKK KEKE KKKRK KEK KKH 


WELCOME 


KKK KK KKK KEKE KKK KKK KKK KK KKK KEKE KKK KKK KKK KKK KE KKK KKK KEK KKK KKK KKK 


WELCOME lee site MOO aie mene: MUS Peek ier LY, LETS 
PIsCUsSS WHAT THE MODEL MENU IS AND WHAT IT ISN'T, TO 
HOPEFULLY AVOID ANY CONFUSION AS YOU BEGIN TO FAMILAIARIZE 
YOURSELF WITH THE DYNAMICA MODEL OF SOFTWARE PROJECT 
MANAGEMENT. 


I. COMPONENTS OF THE MODEL MENU 


THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
IS A SOPHISTICATED SIMULATION MODEL WRITTEN BY DR. TAREK 
K.ABDEL-HAMID, IN PROFESSIONAL DYNAMO. PROFESSIONAL 
DYNAMO (ABBREVIATED PD ) IS A HIGH LEVEL SIMULATION 
LANGUAGE CREATED BY PUGH — ROBERTS ASSOCIATES, INC. 

ACCESS TO THE SYSTEM DYNAMICS MODEL OF SOFTWARE 
MANAGEMENT IS PROVIDED BY THE MODEL MENU. THE MODEL 
MENU , WRITTEN USING EXTENDED BATCH LANGUAGE, DOS 
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COMMANDS, SEVERAL PUBLIC DOMAIN BATCH FILE UTILITIES Ars 
THE PD INTERFACE LANGUAGE DYNEX, HAS 3EEN DESIGNED TO 
EASE AND SPEED USER ACCESS TO THE MODEL AND AID IN 

THE MANIPULATION OF SIMULATION RESULTS. 


HIT ANY KEY 2 Teen ren Be 
END 
BAT INKEY 
BAT CLS 
ECHO FOR 
BAT REM FILE NAME: HARDWAR. BAT 
BAT CLS 
BAT BEGTYPE 


LOA %# RRR RRR RKRRKRRKEKKREKKRKRRAE KKK ee 


HARDWARE AND SOFTWARE REQUIREMENTS. 


KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKEKKKKKKK 


HARDWARE: 


THE MODEL REQUIRES AN IBM OR IBM COMPATIBLE Xt 
MICROCOMPUTER, WITH 640 K OF RAM AND A HARD DISK OR 
Ll CaM EG we EOe rE. 

EXECUTION OF MODEL SIMULATIONS IS A VERY 
NUMERICALLY INTENSIVE OPERATION. THE @BABCUTTON@S Faas 
INCREASES TREMENDOUSLY WITH THE USE OF A MATH 
CO-—P ROCESSOR VGH ae. 


THE MODEL PROVIDES SUPPORT fOR THE MOST Comer 
GRAPHIC DISPLAY MODES, MDA, CGA AND EGA. THE MODEL'S 
USE OF COLOR IS DESIGNED TO ENHANCE USABILITY EU tee 
NOT A REQUIREMENT. 


SOFTWARE: 


THE MODEL REQUIRES MS "OR PC OOS 27xx OR GRE Tare 
CHECK TO MAKE SURE ALL THE ribES LISTED ON THE Sistem 
DISK ARE PRESENT IF ANY PROBUDEMS SAR ESE 


HIT ANY KEY TO CONTINUE 


END 

BAT INKEY 

BAT CLS 

PenOs Ont 

BAT REM FILE NAME: SUGGEST. BAT 
BAL ers 

BAT BEGTYPE 
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pe KKK KKK KK KKKKEKKKEKEKKKKEKKEKKKKKEKKKEKAKEKEKERKKEEKEKEKE 


SUGGES LIONS. 2 


KKK KKK KKK KKK KKK KKK KKK KEKE KKK KKK KEKE KK KKK KEK KKK KEK KEK KKK KKK KEK KK 


Titans eK CCOMENDED ORDER OF BUSINESS FOR ALL 
NEW USERS IS TO FAMILIARIZE YOUR SELF WITH THE MODEL MENU. 
TAKE A FEW MOMENTS AND EXPLORE ALL THE MENU SELECTIONS. 
THERE IS NO NEED TO ENTER DATA OR RESPOND TO ANY OF THE 
OUBRIES, JUST SCAN THE SCREENS AND HIT ENTER OR ANY KEY AS 
PROMPTED TO CONTINUE. THIS WHOLE PROCESS SHOULD ONLY TAKE 
YOU 10 MINUTES OR SO. WRITE DOWN ANY QUESTIONS THAT COME TO 
MIND AS YOU SCAN. 


IF YOUR QUESTIONS ARE BEGINING TO DEAL MORE WITH HOW 
AM I GOING TO USE DYNAMICA TO BETTER UNDERSTAND SOFTWARE 
PROJECT MANGEMENT AND HOW CAN [I CUSTOMIZE IT, IT IS TIME FOR 
mower GO TO THE NEXT STEP. 


HIT ANY KEY TO CONTINUE 
END 
BAT INKEY 
Boe CLS 
BAT BEGTYPE 
TEP ECCCCLCSSSLCLSSCLCLSCLCLCLSCCLSoOCCLSoSCSSSCSSSCSCSSSCSSSCS CSCC CSCS TTT 
REVIEW THE MODEL VARIABLE 
DEFINITIONS 


KEK KKK KKK KKK KKK KKK KKK KEK KE KKK KKK KK KKK KKK KKK KEK KEK KKK KKK KKKK 


EP Your PLANeTO USE THE MODEL TO SIMULATE A 

PARTICULAR SOFTWARE PROJECT THAT YOU HAVE DATA ON, THE 
MODEL SHOULD BE CUSTOMIZED TO REFLECT THAT PROJECT. YOUR 
FIRST STEP TOWARDS THAT GOAL IS TO DISCOVER WHAT VARIABLES 
ARE AVAILABLE IN DYNAMICA AND WHAT THEY REPRESENT IN THE 
MODEL. YOU AND THE MODEL HAVE TO UNDERSTAND ONE ANOTHER. 
POR EXAMPLE, IF HIRING DELAY IS A VARIABLE YOU WISH TO 
mesoot, YOU MUST UNDERSTAND HOW IT IS DEFINED BY THE MODEL. 


HIT ANY KEY TO CONTINUE 
END 
BAT INKEY 
eo. CLS 
BAT BEGTYPE 


NOTE: 


THE QUANTITATIVE TYPES READING THIS ARE ALREADY 
SAYING TO THEMSELVES, WHY DON'T THEY GIVE US THE EQUATIONS 
THE MODEL USES, THEN I CAN REALLY FIGURE OUT WHAT'S GOING ON. 
UNFORTUNATELY, TO DO THAT WOULD REQUIRE THAT YOU BECOME 
FAMILIAR WITH FAR MORE VARIABLES THEN THE 20 PRIMARY 
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VARIABLES ADJUSTABLE VIA THE MENU, LIKE ROUGHLY 150 MORE, AND 
BECAUSE THIS IS A DYNAMIC MODEL aib KSBAT ICON Shwe eevee 
THROUGHOUT THE LIFE OF THE SOFTWARE PROJECT. THATS WHY 
COMPUTER MODELS ARE SO VALUABLE. IN A FEW MINUTES TIME, THE 
MODEL VARIABLES CAN BE ADJUSTED AS YOU SEE FIT, A SIMULATION 
CAN BE RUN WITH THOSE VARIABLES AND RESULTS STORED ON OVER 
QUANTITATIVE MEASURES OF PROJECT PERFORMANCE. 


HIT ANY KEY TQ CONTINUE 
END 
BAT INKEY 
BAT CLS 
Beno “Ore 
BAT REM FILE NAME: OVER. BAT 
pal CLS 
BAT BEGTYPE 


LOR * ® KR KK RR KK KKK RKKRKREKRKKKRKEKKKKKAKKKAKKKKKKKRKKKAKAKAKKK KK 


OVERVIEW OF AVAILABLE HELP FACILITIES 


KEK KK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK 


THERE ARE TWO TYPES OF HELP AVAILABLE TO THE USER: (1) 
ONLINE MODEL HELP AND (2) PROFESSIONAL DYNAMO HELP. 


ONLINE MODEL HELP IS AVAILABLE TO THE USER WHEN 
UTILIZING SELECTION # 3 OF THE MAIN MENU - VARIABLE 
MANIPULATION. AT ANY PROMPT, THE USER NEED ONLY TO TYPE 
(H)ELP (H)ELP TO GET A LIST OF AVAILABLE HELP CATEGORiiSs 


PROFESSIONAL DYNAMO HELP PROVIDES THE MORE EXPERIENCED 
MODEL USER ACCESS 70°38 FPRetELESICrres. 


HIT ANY KEY TO CONTINUE ! 
END 
BAT INKEY 
BAT CLS 


Iso OA ORI 

BAT REM FILE NAME: HELP. BAT 
BAT CLS 

BAT BEGTYPE 


\OAX* * & & & & KKK KK KK OK eK OK KK OK OK KO Kk kK kk kK ek ek ok 


ONLINE MODEL HELP INFORMATION 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KKK KKK KKK 
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THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
feoetms CAPABILITY FOR EXTENSIVE, USER DEFINED, EASILY 
MODIFIABLE HELP. ACCESS TO THIS HELP IS AVAILABLE WHILE 
UTILIZING MAIN MENU SELECTION # 3, MODEL & VARAIBLE 
MANIPULATION. THIS HELP CAPABILITY IS A FEATURE OF 
PROFESSIONAL DYNAMO, DESIGNED BY PUGH-ROBERTS ASSOCIATES, 
NC. 


POBeCCi oo gaN EXAM P EE OF THis HEEP, Ine USER SIMPLY 
TYPES (H)ELP (H)ELP FOLLOWED BY ENTER. 


Dive eaAtiy shiy TO “CONTENUE 


END 
BAT INKEY 


Bee CLS 


Beno OFF 
BAT REM FILE NAME: SIMULAT. BAT 
BAT CLS 
Bet BEGTYPE 
\OA 
YOUR RESULTS ARE BEING STORED IN THE PROPER FORMAT ! 


END 


mae TYPE TIME( C ) 
BAT TYPE DATE() 


REP PROJECT STATS 


BAT CLS 
BAT BEGTYPE 
\OA 


PLEASE ENTER THE FILE NAME YOU DESIRE FOR THIS REPORT. 
IT IS SUGGESTED THAT YOU NAME YOUR FILES IN A MANNER 
WHICH WILL ALLOW THE MAXIMUM BENEFITS OF THE DOS 
WILDCARD 

( * ) FEATURE WHEN MANIPULATING YOUR FILES. 


BABRMPLE: (PROJECT. *) 


Be, 


NOTE: 
CHANGES MADE TO VARIABLES ARE STORED IN THE 
FILE. FOR EXAMPLE IF HIRING DELAY WAS CHANGED 
FROM 30 TO 40, THAT INFORMATION WOULD BE STORED 
AT THE END OF THE REPORT. 


END 

BAT READ %0 

BAT CLS 

BAT BEGTYPE 

\OA 

ENTER THE FULL PATH NAME OF THE DIRECTORY WHERE YOU 
WOULD LIKE THE RESULTS STORED. 

END 


BAT READ %1 

REN PROGECT OU eso 

COPY %0 + PROJECT.WAS 

COPY %0 %1 

ECHO ORE 

BAT REM FILE NAME: PRINT. BAT 
BAT CLS 


D /6 

BAT TYPE HIT ANY KEY TO CONTINUE ! 
BAT INKEY 

> AGAIN 

BAT CLS 

BAT BEGTYPE 


\OA 
PLEASE ENTER THE FULL NAME OF THE FILE YoU" WOULD ii 
PRINTED. YOU MAY USE DOS WILDCARD ( * ) SYMBOLS GigE 
PRINTING MORE THEN ONE FILE AT A TIME. 
OTHERWISE, PLEASE TYPE °*@) TOsoQur 
EXAMPLE: (MONDAY. *) 

END 


BAT read %2 
BAT IF %2 = Q THEN EXIT 
BAT ELSE 


COPY %2 PRN 
BAT GOTO :AGAIN 
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Beno OFF 

BAT CLS 

BAT REM FILE NAME: OVERVIE. BAT 
BAT BEGTYPE 


emo OFF 

BAT REM FILE NAME: PLOT1.BAT 
BAT CLS 

Pet BEGTYPE 


eee RK RK KKK RK KKK KKKAKKRKRKAKRAKKKARKRKKAKKKKRRKARRKKKKAKRKKKKS 


PLOT 1 


KREKKE KKK KKK KKK KKK KEK KKK KKK KKK KEK KKK KKK KEKE KKK KEK KKK KKK KEK KK KKK KKK KK 


PLOT 1 GRAPHS THE FOLLOWING VARIABLES: 


Semel. 2 oe 6 ek fs ESMRMATED SCHEDULE IN DAYS 
a) 13 S\ 4 a a "PERCEIVED Prove] ssolbZe tN TASKS 
JBSZMD ..... . . ESTIMATED PROJECT COST IN MAN-DAYS 
DOU. ee cre ee LOLAL) WORKFORCE PEOPLE 
SerMDe . 2). » . . | . CUMULATIVE MAN-DAYS EXPENDED 


{iP YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)O. 


END 
BAT INKEY “%0 


Bat CLS 
BAT IF Y¥Y = %0 THEN GOTO EGA 
Eat ELSE GOTO OTHER 


> EGA 

mee PROJECT PLOT1 -PLM 6 
eat GOTO -NEXT 

BOTHER 

Beer PROJECT PLOT1 


fal 


BAT -NEXT 
BAT CLS 

BAT BEGTYPE 
\OA 


IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, CTAEKVISES ene Cee 
RETURN TO THE MENU: 


END 

BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 
BAT ELSE GOTO NAME 

: NAME | 

REN PLOT 1.0OUT %! 


7s bEAVE 

BATE 

BCHOMOrE 

BAT REM FILE NAME: PEOTZ oe & 
BAT CLS 


BAT BEGTYPE 


LOR * KKK KK KKK KR KR KKK KR RK KR KKK KR KKK KR KKK KKK KK KK KR KK KK KR KK RK KK KKK 


PEO eZ 


KKK KKK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


FIRST, A QUICK REVIEW OF THE VARIABLES BEING 


PEC Prisw:. 

CMTKDV 2.6.2.0» «2. & «= «~ CUMULATIVE STASKS SDE MEE nD 
CUMTKT . 3. su ne oc A ce ee tee 
CUMMD - we eo we ew wh Ul el 6CUMULATEY EMAN DA ete ene ane 
PJBSZ .. «. « » » « PERCEIVED PROD Pets 4 eons 
PDEVRC .. . . 4. . « BSTEMATED)% DEVEBOCPHEN Teor eas 


IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N70. 


END 
BAT INKEY %0 


BAT CLS 
BAT IF Y = %0 THEN GOTO EGA 
BAT ELSE GOTO OTHER 


>: EGA 

REP PROJECT PLOT2 -PLM 6 
BAT GOTO -NEXT 

;OTHER 

REP PROJECT PLOT2 
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Een -NEAT 


BAT CLS 

BAT BEGTYPE 

\OA 
IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, OTHER WISE TYPE (Q) TO RETURN 
TO THE MENU. 

END 


BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 
BAT ELSE GOTO NAME 

:NAME 

REN PLOT2.OUT %1l 


: LEAVE 

Bar EXIT 

men OFF 

BAT REM FILE NAME: PLOT3. BAT 
BAT CLS 


BAT BEGTYPE 


wo KKK KEKE KKKKKKKKKKKKKEKKKEKKKEKKKEKKKKEKKKEKKKKKKEKKKEKKKKEKE 


PLOT 3 


KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KEKE KKK KKK KK KKK KKK KKK KKK KKK KKK 


FIRST, A QUICK REVIEW OF THE VARIABLES BEING 


PeoulTED: 

MBE CsCl eC tl Cll Cl el wlCUltwlCUlelCUmtlCUwte CU6LLOTAL WORKFORCE 
Pewee 6l.lCUlwlCUlwlCw!6CUdM RAC TION OF WORKFORCE THAT [IS EXPERIENCED 
eet OMe rs lel. Uw PRODUCTIVITY 

MeaOrM . 2. . wlltlwlCUltlmwlCUlmDUCUwwCUwwWLCULwW COMMUNICATION OVERHEAD 


heer OU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)O. 


END 
BAT INKEY %0 


Beat CLS 
BAT IF Y = %0 THEN GOTO EGA 
seat BLSE GOTO OTHER 


> EGA 
REP PROJECT PLOT3 -PLM 6 
BAT GOTO -NEXT 
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salut ets 
REP PROJECT PLOT3 


BAT -NEXT 
BAT SEES 
BAT BEGTYPE 


IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, OTHER WISE TYPE (Q) TO RETURN 
TO TAE SMBs 


END 

BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 
BAT ELSE GOTO NAME 

>NAME 

REN PLOT3.OUT %*1l 


> LEAVE 

BAT EXIT 

Beno One 

BAT REM FILE NAME: PLOT4. BAT 
BAT CLS 


BAT BEGTYPE 


LOD KKK KKK KKK KKK KKK KKK KK KK KKK KK KKK KK KK KKKKK KKK KKK KKK KK KK KKK 


PLOT 4 


KEK KK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


FIRST, A QUICK REVIEW OF THE VARIABLES BEING 


PLOTTED: 

AFMPDJ .. . . ACTUAL FRACTION OF A MAN-DAY ON PROJECT 
JBSZMD .... . . PERCEIVED TOTAL JOB SIZE IN MAN-BAYsS 
PUBSAZ . 2. 3 » 1 a ea SS ee PERRET Y Bi ORs baie eee tele 
PMDSHR .... .. . . . PRBROEEIVED SHORTAGE Th Mat Sees 


IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)O. 
END 
BAT INKEY %0 
BAT CLS 


BAT IF Y = %0 THEN GOTO EGA 
Bel ELeE GOTO OTEK 
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SEGA 
REP PROJECT PLOT4&4 -PLM 6 
BAT GOTO -NEXKT 


2 ON Oa 
REP PROJECT PLOT4 


aoe NEXT 
BAT CLS 

BAT BEGTYPE 
\OA 


IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS CEGAL FIEE NAME, OTHER WISE TYPE (0) TO RETURN 
TOs int MENU: 


END 

BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 
BAT ELSE GOTO NAME 

:NAME 

REN PLOT4.OUT %1 


>: LEAVE 
BAT EXIT 


(a2 


APPENDIX B 


MODEL MENU SHELL PROGRAM LISTING 


SCHOO OFF 

BATALLF. COM 

GRAPHICS 

bat /N /p /s * .4.4 Eoading . =. MOPED En 
Call —rope 
JO >¢ 326 

EO) goto —-top%A 


KEKE KEK KEK KEKE KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK 


* Remove the following data ONLY if further changes will not* 


* be made x 
> i> a> a> a>, a>, a> a> a> a> a> a>, a> a> di, diy, i>, a> di a> dip aii a> a> a>, a>. a> di, a>, a> a> a> a>, a> ae db, a> a> a> a> di. db. ae. a> a> dip di di db a> db a> a>, di di, a>, a> di a> din 


SMS ae ie 
EBL Extended Variables - Version 1.03 
Current variable contents is: 


&C5 = 17 
&DESCRIP81 = 
&K81 = H 
&DESCRIP91 = 
&KIL = I 
&DESCRIPIOL = 
&KLO1 = J 
SWeoCKR ITP TET = 
&KLIL = K 
SVESCRIPIEZI = 
&KL21 = L 
&DESCRIPI31 = 
sak Gilk = M 
&DESCRIP141 = 
&KL41 = N 
&DESCRIPI51 = 
&KI51 = 0 
&DESCRIP161 = 
&K161 = P 
&DESCRIP171 = 
Shel 71 = Q 
&DESCRIP181 = 
&K181 = R 
SvioaCk ie il = 
&K1IIL =o 
&DESCRIP2Z01 = 
&K201 = T 

&C1 = 1F 

&C2 = 1A 


(A= 


ECS = 1A 

&C4 = 1D 

&NAMEL = MODEL MENU 

Seeger = FOR THE DYNAMICA MODEL OF SOFTWARE PROJECT 
MANAGEMENT. 

&K11 = 1 

&DESCRIPI1 Se tRObveliONetG ThE MODE MENU 
Sere tl = “SUB-MENU-z 

&NAME2 = INTRODUCTION TO THE MODEL MENU 
&DESCRIP42 = 

&K42 = D 

&DESCRIP52 = 

&K52 Sk 

&DESCRIP62 - 

&K62 = F 

&DESCRIP72 = 

&K72 = G 

&DESCRIP82 = 

&K82 =H 

&DESCRIP92 = 

&KI2 = I 

&DESCRIP102 = 

&K102 = J 

&DESCRIP1liI2 = 

&K112 = K 

&DESCRIP122 = 

&K122 = L 

&DESCRIP132 = 

&K1L32 = M 

&DESCRIP142 = 

&K1L42 = N 

SeeocCRIP152 - 

&K152 = 0 

&DESCRIP162 = 

&K1L62 = P 

&DESCRIP172 = 

&K172 = Q 

&DESCRIP182 = 

&K182 = R 

EDESCRIP192 = 

&K192 = 5 

&DESCRIP202 = 

&K20 2 = T 

&K12 = 1 

SUmoCRIP1 2 = PURPOSE OF THE MODEL MENU 
eeMmol2 = 22187 2 

&K22 = 2 

&DESCRIP2Z2 = HARDWARE/SOFTWARE REQUIREMENTS 
Bem 22 = 22226 2 

meeouMe2 = i 23DEFGHIJSIKLMNOPOQORST 
&K32 = 3 | 
&DESCRIP32 = SUGGESTIONS FOR USING THE MENU 


iy 


&TITLE2 = THE FOLLOWING MENU PROVIDES INRTODUCTORY 
INFORMATION TO NEW USERS. 

&K21 = 2 

SURSCKIP ZI = HELP FACILITIES 

&CMD21 = ~SUB-MENU-3 

&NAME3 = HELP FACILITIES 

&DESCRIP43 = 

&K43 = D 

&DESCRIPS3 = 

&K5 3 = E 

&DESCRIP63 = 

&K63 = F 

&DESCRIP73 = 

&K73 = G 

&DESCRIP83 = 

&K83 = H 

&DESCRIPSS = 

Paes) = I 

&DESCRIP103 = 

&K103 = J 

&DESCRIPIIS = 

&K113 = K 

SDE SCRIP iS = 

&K123 = L 

&DESCRIP133 = 

&K133 = M 

&DESCRIP143 = 

&K143 = N 

SDE SC Riera 3 = 

&K153 = O 

&DESCRIP163 = 

&K163 = Pp 

&DESCRIP173 = 

Sky 3 = Q 

&DESCRIP183 = 

&K183 = R 

&DESCRIP193 = 

&K193 = 38 

&DESCRIP203 = 

&K 20 3 = T 
&K13 = 1 
&DESCRIP13 
SCMD US 2=222287. 2 

&TITLE3 = INTRODUCTION TO DYNAMICA AND PROFESSIONAL DYNAMO 
HELP FACILITIES. 


OVERVIEW OF HELP FACILITIES 


&K23 = 2 

&DESCRIP23 = ONLINE MODEL HELP INFORMATION 
CEM D239 PCS 22325 42 

&KSUM3 = 123 DE F GH Ef JK CMW N Oe Oo Ree 
&K33 = 3 

&DESCRIP33 = PROFESSIONAL DYNAMO HELP 

&CMD33 = ~SUB-MENU-4 
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&NAME4 = PROFESSIONAL DYNAMO HELP 


&TITLE4 = THE FOLLOWING MENU PROVIDES ACCESS TO PD HELP 


&DESCRIP94 

&KI4 = I 
&DESCRIP104 
&K104 = J 
&DESCRIP114 
&K114 =F 
SDESCRIP124 
&K124 = L 
&DESCRIP134 
&K134 = M 
&DESCRIP144 
&K144 = N 
&DESCRIP154 
&K154 = O 
&DESCRIP164 
&K164 = P 
&DESCRIP174 
&K174 = 0 
&DESCRIP184 
&K184 = R 
&DESCRIP194 
&K194 = 58 
&DESCRIP204 
&KZ04 = T 
meelLITLES. 
&K14 = 1 
&DESCRIP14 
&CMD14 = 22359 
&KZ4 = 2 
&DESCRIP2Z4 
&CMD2Z4 = 22377 
&K34 = 3 
&DESCRIP34 
&CMD34 = 22398 
&K44 = 4 
&DESCRIP44 
&CMD44 = 22418 
&K54 = 5 
&DESCRIP54 
&CMD54 = 22438 
&K6 4 = 6 
&DESCRIP64 
&CMD64 = 22459 
&K74 = 7 
&DESCRIP74 
&CMD74 = 22479 
&KSUM4 = 1 2 3 
&K8 4 = 8 
&DESCRIP84 
&CMD84 = 22500 


I I NII 


m O II i) 


tho 


OVERVIEW OF PD HELP 


DYNEX HELP 


EDITOR HELP 


SIMULATION HELP 


LOOKS] GEky 


TRANSLATOR HELP 


UITEtT ibs BEEP 
Soe 7o led eee tne Oo, POR Ss T 


VIEW HELP 


Fe) 


&K31 = 3 


&DESCRIP3I = VARIABLE MANIPULATION 
&CMD31 = 22520 

&K41 = 4 

&DESCRIP41 = RUN SIMULATIONS 
&CMD41 = 22559 2 

&K6 1 = 6 

&DESCRIP61 = VIEW RESULTS AND PRINT GRAPHS 
&CMD61 = 22597 2 

&K 71 = 7 

&DESCRIP7 1 = EXIT TO DOS 

SMI? 1 = 922636 72 

&KSUME = 123 4 5 6 7 elo Kh Leen eee eRe. 
&K5S1 = 5 

&DESCRIP51 = TO STORE AND PRINT RESULTS 
SCMDS1l° =. SUB-—MENU-=S 

&NAME5 = TO STORE AND PRINT RESULTS 
&DESCRIP45 = 

&K45 = D 

SVibSeR be as = 

ye 2 = E 

&DESCRIP65 = 

&K65 = F 

&DESCRIP75 = 

&K75 = G 

&DESCRIP85 = 

&K85 = H 

SDEsen ir os = 

&KI5 = I 

&DESCRIP105 = 

&K105 = J 

&DESCRIP115 = 

Gh = K 

&DESCRIP125 = 

&K125 = L 

SVE oeCk IPSS = 

&K135 = M 

&DESCRIP145 

&K145 = N 

&DESCRIP155 ~ 

filo S = 0 

&DESCRIP165 = 

&K165 = Pp 

&PESCRIP ky > = 

&K175 = Q 

&DESCRIP1S5 = 

&K185 = R 

&DESGRIPIY95 = 

Shes = $ 

&DESCRIP205 = 

&K 205 a 


&LETEeS THIS MENU ALLOWS THE USER TO STORE AND PRINT 
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SIMULATION RESULTS. 


&K15 = 1 

&DESCRIP15 = STORING STATISTICS 
Seo lS = 22655 2 

&K25 = 2 

&DESCRIP25 = PLOTTING RESULTS 
meeee> =~ lm@z3sDEF GHIJSJKL_MNOPQRST 
&K35 = 3 

&DESCRIP35 = PRINTING YOUR RESULTS 
&CMD35 = 22730 2 

SGMD32 = 22767 2 

&CMD25 = “SUB-MENU~6 
&NAMEG = PLOTTING RESULTS 
&DESCRIP66 = 

&K66 = F 

&DESCRIP?76 = 

&K76 = G 

&DESCRIP86 = 

&K86 = H 

&DESCRIPSY6 = 

&K96 = I 

&DESCRIP106 = 

&K106 = J 

&DESCRIP1I16 = 

&K116 = K 

SemoCRIP126 = 

&K126 = L 

&DESCRIP136 = 

&K136 = M 

&DESCRIP146 - 

&K146 = N 

&DESCRIP156 = 

&K156 = O 

&DESCRIP166 = 

&K166 = P 

&DESCRIP176 = 

&K176 = Q 

&DESCRIP186 = 

&K186 = R 

&DESCRIP196 = 

&K196 = 35 

&DESCRIP206 = 

&K 206 = T 

&K16 = 1 

&DESCRIP16 = OVERVIEW PLOTTING FUNCTIONS 
PeMDI6  "="22806 2 

&K26 = 2 

&DESCRIP26 = PLOT 1 
&CMD26 = 22845 2 

&K36 = 3 

&DESCRIP36 = PLOT 2 
&CMD36 = 22882 2 
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&K46 = 4 


&DESCRIP46 =""LOT 32 

&CMD46 = 22919 2 

&KSUM6 =12345F GHi JK LMNOPOQORS TF 
&K56 = 5 

&DESCRIP56 = PLOT 4 

&CMD56 = 22956 2 

& I = title 

&TITLE6 = THE FOLLOWING MENU ALLOWS THE USER TO VIEW AND SAVE 
4 PREDEFINED PLOTS. 

& LVL = ] 

& PAGE = 1 


10000 bytes allocated 2641 bytes free 

KEK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKK KE KKK KKK KKK KKK KK KKK SK 
* Remove the previous Gata ONDY GE Eurtner changes wim. 
- not be made a 
KREEK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK 


-topl *A = 1 


Golor Vir 
ram 
cls 
begtype 
L MENU pee 
\LA FOR THE DYNAMICA MODEL OF SOFTWARE PROJECT 
MANAGEMENT. VIE 
Nae) \1F INTRODUCTION TO THE M@iiis 
MENU 
el one 2 \ ITF HELP FACTUITIES 
Op i Des \IF VARIABLE MANIPULATION 
\1D 4 \1F RUN SIMULATIONS 
VED \1F TO STORE AND PRINT 
RESUGTS 
Ne iLID) as \1F VIEW RESULTS AND PRINT 
GRAPHS 
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Ghneose an option: 


end 


-lstkeyl inkey %0 | 


-2ndkeyl inkey %1 | 


— aan 


-4™1 


moo 1 


Sees 7 Woes ALT SO ees 


(ESC exits menu):; 


ee 
if %*0 = keyOlb 
goto -%*071 


%O0 # = 
return 


1 type %0; 


ee 
keyQlb 
key020 
keyQ0d 
key008 
keyl4b 
-%0%11 


*l # = 
ie Seu th 
goto -$%0$l 
goto -$%0S1 
JGatou— LOpL 
210) 15ie) —elehe\l! 


1 type %1; 
mi 6 L 
ae ee 
if %1 
if %1 
if %1 
GOuG 


Kx*K* 


ars INTRODUCTION TO THE MODEL MENU 
eal —-Eop2 

Bae /D /S goto -topl 
Meeoeitoie FACILIPISsS ~*** 
ea! —too3 

sat /99/s goto —topl 

BAxs VARIABLE MANIPULATION **** 
BAT CLS 

BAT SHELL BAT /R VARIABL. BAT 
Date; > Gotan Lop L 


a -oRUN SIMULATIONS **** 
BAT CLS 

BAT SHELL BAT /R RUNSIM.BAT 
is ae oy Ss JOO. —top L 


foo Oe olORE AND) PRINY RESULTS **** 
GEL \creieps) 
Bae, 7S Gote —topl 
KKK VIEW 
BAT CLS 

BAT SHELL 
bat /p /s 


RESULTS ANDRE RINDSEGRAPHS **** 


BAT /R VIEWSIM.BAT 
o(e) Efe) =e) /e) 1 


KKK ExT 
BAT CLS 

BAT EXIT 
bive () S 


TO DOS **2as 


Jabom —eapt 


-$%0 $1 


-%0%11 beep goto 


=100. 3 jh 


-top2 %A = 2 


26 


eolor  \eee 


ram 
cls 
begtype 
O THE MODEL MENU ie 
\LA THE FOLLOWING MENU PROVIDES INRTODUCTORY INFORMATION 
TO NEW USERS. rs 
Se ae! \1F PURPOSE OF THE MODEL MENU 
VED eZ \1LF HARDWARE/SOFTWARE 
REQUIREMENTS 
\ Pees \1F SUGGESTIONS s®@Re USING 
MENU 
Choose an option: (ESC exits menu):; 
end 


-lstkey2 inkey %0 | if %0 # = 1 type %0; 
if %0 = keyOlb return 
goto -%0~2 

-2ndkey2 inkey %1 | 1£ %1 # = 1 type “%1l; 


if %*1 = keyOlb return 

if %*1 = keyQ20 goto -$%0$2 
if %*1 = key00d goto -$%0$2 
if %*1 = key008 goto -top2 

if %1 = keyl4b goto -top2 

goto -%0%12 


—1"2 **** PURPOSE OF THE MODEL Mbhte ~~~ 
Bedale 
BAT SHELL BAT /R PURPOSE. BAT 
bat” /D7/s Goro =fooZ 


—2°2 **** HARDWARE/ SOFTWARE REOULREMEND Sa. 
BAT sels 
BAT SHELL BAT /R HARDWAR. BAT 
Dake vo /Segqota, =Eopz7 


=—3°2 **** SUGGESTIONS FOR USING THES MEN es 
BAT CLS 
BAT SHELL BAT /R SUGGEST. BAT 
Dak, = pias OGeG =o 


—%0~2 
-$%0S$2 


-%0%12 beep goto -top2 
-top3 *%*A = 3 
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exenliejc 3 Je 


ram 
cls 
begtype 
SLGLTIES EE 
\1A INTRODUCTION TO DYNAMICA AND PROFESSIONAL DYNAMO 
aeG@e FACILITIES. \1F 
eer \1F OVERVIEW OF HELP 
Pee TLES 
ri 2 \1F ONLINE MODEL HELP 
INFORMATION 
Ne 23 \1F PROFESSIONAL DYNAMO HELP 
Choose an option: PoGewexits menu): 


end 

Sistkey3 inkey *%0 | if 40 # = 1 type %0; 
if %*0 = keyOlb return 
JOco.—s0 03 

-2ndkey3 inkey %1 | 1£ %*1 # = 1 type %1; 


1£ %*1 = keyOlb return 

if %*1 = key020 goto -$%0$3 
1£ %*1 = key00d goto -$%0$3 
if %1 = key008 goto -top3 

if %*1 = keyl4b goto -top3 


goto —-%0%13 


fees ~~ OVERVIEW OF HELP FACILITIES **** 
BAT CLS 
BAT SHELL BAT /R OVER. BAT 
Bae, pa/S Goto —tops 


eee” * ONLINE MODEL HELP INFORMATION **** 
BAT CLS 
BAT SHELL BAT /R HELP. BAT 
Sarmeyo/S GOorO -top3 


memes ~~~ PROFESSIONAL DYNAMO HELP **** 
call -top4 
Bate, S Goto —top3 


seo 2 
—-$%0$3 
-%0%13 beep goto -top3 
-~top4 *A = 4 
eolorn, \1F 
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ram 


ers 
begtype 
L DYNAMO HELP Vie 
\1A THE FOLLOWING MENU PROVIDES ACCESS TO PD EEE 
FACIEIT#Ss.: Re 
pee \1F OVERVIEW OF PD HELP 
VID 2 \ IF DYNEX BEL 
\ Dae \1F EDITOR HELP 
\1D 4 \1F SIMULATION HELP 
VLD \LF TOOLS PEEP 
VED SG \1F TRANSLATOR HELP 
sea Birr VIF UTE ieSenee 
\ IDs \1F VIEW HELP 
Choose an option: (ESC exits menu):; 


end 

-lstkey4 inkey %0 | i1£ %0 # = 1 type %0; 
if %*0 = keyOlb return 
goto -%0~4 

-~2ndkey4 inkey %l1 | if %*1 # = 1 type %l; 


if %*1 = keyOlb return 

if %l1 = keyQO20 goto -$%0$4 
if %1 = keyOOd goto -$%0$4 
if %*1 = key008 goto -top4 
if *1 = keyl4b goto -top4 


goto -%0%14 


86 


meme ~~ *~** OVERVIEW OF PD HELP **** 
BAT CLS 
ieee TP 
bat /p /s goto -top4 


eee ** DYNEX HELP =*** 
BAT CLS 
L DYNEX.HP 
Sau Pp /Ssugoto,-top4 


pemeee ~~~ EDLTOR HELP **** 
BAT CLS 
Eb EDIR-AP 
bat /p /s goto -top4 


moe * ~*** STIMULATION HELP **** 
BAT CLS 
Peomil, AY 
Dates Dp /S goto —top4 


meee ~*~ TOOLS HELP **** 
BAT CLS 
L TOOLS.HP 
bat /p /s goto -top4 


mea ~*~** TRANSLATOR HELP **** 
BAT CLS 
L TRNS.HP 
bat /p /S goto -top4 


SUT hot Trtbs HELP **** 
Baw CLs 
PeUL tes. aP 
pate, pn/S Goto —top4 


momo ~*** VIEW HELP **** 
BAT CLS 
L VIEW.HP 
baue/p /S goto —-top4 


—-%0~4 

-$%0$4 

—-%0%14 beep goto -top4 
means %*A = 5 


color \ LF 
ram 
cls 
begtype 
PReNT RESULTS \2F 
VA THIS MENU ALLOWS THE USER TO STORE AND PRINT 
SIMULATION RESULTS. ere 


a7 


VD \ITF STORING STaAtTisi2e. 


hae \1F PLOMBING KESUETS 


ei Dies \1IF PRINTING YOUR KESUEES 


Choose an option: (ESC exits menuj)c? 
end 
-lstkey5 inkey %0 | if *0 # = 1 type %0; 
if *0 = keyOlb return 
Go EO) -6055 
-2ndkey5 inkey %1 {| if %*1 # = 1 type %l; 


if *1 = keyOlb return 

if %*1 = key020 goto -$%0$5 
if *1 = key00O0d goto -$%0$5 
if %*1 = key008 goto -top5 
if *1 = keyl4b goto -top5 


goto -%0%15 


~1~5 **** STORING StAltsl res... 
BALE-CiS 
BAT SHELL BAT /R SIMULAT. BAT 
bat /p /s goto "—-croDs 


=Z2 2) *** PLODTUNG Biba ioe. 
call —-Loo6 
bat /p /S-geto rte 


—-3 5 **** PRINTING YOUR RESULTS 
BAT CLs 
BAT SHELL BAT /R PRINT.BAT 
bat. /p /S goto —tops 


0M oO 
-$%0$5 
-%0%15 beep goto -top5 
-top6o %A = 6 
Gon Or Salt 
ram 
cls 
begtype 


G RESULTS NEE 


\1A THE FOLLOWING MENU ALLOWS THE USER TO VIEW AND SAVE 4 
PREDEFINED PLOTS. \1F 


88 


FUNCTIONS 


Choose an option: 


end 


-lstkey6 inkey %0 | 


-2ndkey6 inkey %1 | 


aa 6 


i£ %0 


Vr OVERVIEW PLOTTING 


es JEON i 


EE, NE Bon 


SED, Nel cee ser 


VED VUE PLO 


(BoC ex1EsS menu) <> 


if 
keyOlb 


%O0 # 
be Cubam 


1 type %0; 


goto -%0~6 


% 1 
%1 
%1 
i£ *%1 
if %1 
goto 


Lae 
ee 
lets 


Mae Se OVERVIBW PLOTTING 


BAS CLS 
BAT SHELL 
bat /p /Ss 


x*xK* PLOT 
BAT CLS 

BAT SHELL 
bat /p /s 


x¥eK* PROT 
BAT CLS 

BAT SHELL 
bat /p /s 


eK PLOT 
BAT CLS 

BAT SHELL 
bat /p /s 


aN 6 
keyOlb 
key020 
key00d 
key008 


key1l4b 


%1 # 
return 

goto -$%0$6 
goto -$%0$6 
Slee ate es. 
eo) iGlo}™ Eee) s. 


1 type %1; 


—-%0%16 


ING ONS eaten oh 


BAT /R OVERVIE. BAT 
efe)ple) eel ais: 


1 KKK 


BAT Vk PHOT BAD 
Go Com eOp6 


2 KKK 


BAT /R PLOT2. BAT 
SEO —EOOb 


3 wkeEK* 


BAT /R PLOT3.BAT 
IaQtq +[eLOOG 


a 


-5~6 KKK * PLOT 4 KKK 
BAT Cus 
BAT SHELL BAT /R PLOT4.BAT 
bat /p /S =dObO=— tan 


—-%0~6 
-$%0$6 
-%0%16 beep goto -top6 
=OlY- eCrron— 
if %R > 32 if %R < GOMEeyocm. 
=~CauG., 


Floating Point Error!) |qeume 


Cls beep type Unexpected batch file error %R in line %L 


jexit 
“Z°S°S°2S"°S 24 a GS Go Gea me a Go cn een i ee 
“EG OCS" S* GS" S°S4°S° SG aah Ga oe Le oe ee ee ee ee, 
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APPENDIX C 


DYNEX MODEL INTERFACE PROGRAM LISTING 


display clear 
KEKK KE KKK KEKE KKK KK KEKE KE KKK KKK KR KEK KKK KEKE KKK KKK KKK KKK KKK KEKE KKK KKK KK 
THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
Masenh 12988 


KEK KKK KKK KKK KEK KKK KKK KKK KK KEKE K KKK KEKE K KEKE KKK KK KKK KKK KKK KEK KEKE KEKE 


Press ENTER for a brief introduction to Model and 
Variable Manipulation. 


It is suggested reading for all new users of Dynamica. 

Experienced users will most likely want to skip directly 
to Model and Variable Manipualtion. To do so type (n)o 
followed by enter. 


Press Enter or (n)o followed by Enter to Continue 


dendg 
choice 1 


display clear 

KKK KKK KKK KKK KK KKK KEKE KKK KKK KKK KK KKK KKK KEKE KK KEKE KEK KEK KKK KKK 

WELCOME TO PROFESSIONAL DYNAMO AND THE DYNAMICA MODEL OF 
SOFTWARE PROJECT MANAGEMENT page l 


KEK KK KKK KEKE KKK KEKE KKK KEKE KKK KEKE KKK KEKE KKK KKK KKK KKK KKK KKK KKK KKK 


INTRODUCTION 


Professional Dynamo is a high level model simulation 
language that has been used to create THE DYNAMICA MODEL OF 
SOFTWARE MANAGEMENT. You need to have no knowledge of how 
Professional Dynamo works to use the model. 

THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT, here 
after simply Refered to as DYNAMICA, is a sophisticated 
Simualtion model designed to provide assistance in 
understanding and estimating the numerous and complex 
variables involved ina large software development project. 


Press Enter to Continue 
dendgq 
choice 1 
cend l/l 


oe 


display clear 
KEK K KKK KKK KKK KK KK KK KKK OK KK KK KK KKK KKK KK KKK OK KK KK KKK KKK KK KKK OK 


[nNErCAUGE TO nm page 2 * 
KEK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KK KKK KKK 


To Speed you on your way, a menu system has been 
developed to interface with the model which is written in 
PROFESSIONAL DYNAMO. This menu allows the the user to 
customize the model to fit a particular software project by 
providing access to 18 different variables or table values, 
from three major areas of interest to the software project 
manager: Estimated Project Size, Organizational Environment 
and Policy Variables. A fourth area provides the 
user access to important model controls, the maxlength of 
project an” the save period for data. 


Press Enter to Continue 
dendgq 
choice l 
cend 1/1 


display clear 
RRR KKK KR KKK KKK KKK KKK KKK KK KKK KKK 
Introductwon 
page 3 


KKK KKK KKK KKK KKK KKK KR KKK KKK KKK KKK KR KKK KKK KKK KKK KKK KKK KKK 


When addressing a particular variable, the user may 
chose any value or use a previously defined value. Changes 
to variables from your last simulation are automatically 
stored with your Simulation results if you chose to store 
your results. 

Your first step after you become familiar with the 
mechanics of tne model will be to adjust all the pertinent 
variables to customize the model to represent any specfic 
software project you might have in mind. Otherwise, you may 
use the model " as is ", to conduct your experimentation 
in the relationships of the variables. 


Press any Key to Continue 
dendgq 
choice 1] 
cend l/l 


display clear 


Fe 


KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KEKE KKK KKK KKK KEK KK 


x IP uigigereibkonn ikopg' page 4 * 
KKK K KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KEK KKK KKK KEKE KKK KKK KKK KK 


The DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
has the potential for extensive online help facilities. 
Currently, only one aspect of the online help facility is 
employed, that being HELP on HELP. This has been done to 
demonstrate the available capability. To view the HELP on 
HELP, type (h)elp followed by a space and (h)elp again 
followed by striking the enter/return Key. 


Press Enter to Continue 
dendaq 
choice 1 


cend l/l 
cend 1/1 


display clear 
KR KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK 


= VARIABLE MANIPULATION page 5 * 


RRR KEKE KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK 


The following 18 model varaibles of Dynamica are 
adjustable via the menu. 
They are grouped in 4 categories for easy access. 


lg BolEIMATED ACTUAL PROJECT SIZE 
ie RI BDSI RB. se . . Real Job Size in DSI 
i. VARTABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 
By. RPeocueriy 1 Ey 
COS e Woke. yy. 6% oom Delivered Source 
ins EsuUIGELON ae Task 
Bie Quality 
3. TNERPK . . Error Rate Per 1000 Delivered Source 
Insteuct lon 
oF Staffing Variables 
Aeweiple Wy. ON bes we wee Hiring Delay 
SOM oe te eee eS Poe eon Delay 
Cee EVE. 8s ee ee Uw Ue UAE YraAge Employment 
EL. PODLCGY VARRABLES 
A. Estimation 
7e UNDEST. .. . . . Task Underestimation Factor 
Ce LOND... lll. otal Mandays 
Saeco ev i . + ) ees Time to Develope 


o3 


Press Enter To See the Remaining Variables 
dendq 
choice 1 
cend i/1 


display clear 
KKK RK K KKK KKK KKK KK KKK KKK KKK KKK KK KKK KKK KKK KEK KK KEK KK KKK KKK KKK KK 


MODEL AND VARIABLE MANIPULATION page 6 


KKK KKK KKK KKK KEKE KKK KK KKK KKK KKK KKK KKK KKK KKK KER KKK KK KEK KKK KKK KKK 


B. Resource Allocation 

10. DEVPRT .... . % of Effort Assumed Needed 
For Development 

11. TPFMQA . Fraction of Manpower Devoted to 
Quality Assurance 

12. INDUST 2. 6 2 ee eee eee ip 
Understaffing Factor 

L3s WOWE nee .. « » Willingness Eo Change 


the Work£orce 
om Staffing 


14. TRPHNR .. . % of Experienced Employee Effort 
to Train a New Employee 
15. AMPPS . Average Daily Manpower / Staff 


Expended On Project 


IV. MODEL CONTROL 
16. MAXLEN ...... . . j%Max Length O£ Project 
17. SAVPER . .. .. 4... . SaVe=FPerIOa 1on vate 


Press Enter to See Variable Definitions or to Manipulate 
Variable Values. 
dendg 
choice l 
cend l/l 


display clear 
KKK RK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KERR KKK KKK KKEKRKEKKKEKR KK 


MODEL AND VARIABLE DEFINITION AND MANIPULATION page 7 


RE RK KKK KKK KKK KK KKK KK KKK KKK KKK KR KKK KR KKK KKK KKK KKK KKK KKK KKK KK 


Select one or more of the following eight topic 
areas. You may chose to first look at a brief explanation of 
the variables or go directly to variable manipulation. 


I. MODEL VARIABLE DEFINITIONS 
1. ESTIMATED ACTUAL PROJECT SIZE DEFINITION 
2. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT DEFINED 
3. POLICY VARIABLES DEFINED 
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4. MODEL CONTROL VARIABLES DEFINED 


II. MANIPULATION OF MODEL VARIABLES 
5. ESTIMATED ACTUAL PROJECT SIZE 
6. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 
7. POLICY VARIABLES 
8. MODEL CONTROL VARIABLES 


Enter the number(s) of your selected choices. 
Seperate each choice by a space or a comma. 
dendq 
choices 8 


display clear 
KK KKK KK KKK KK KKK KK KK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK 


BaemimAteD ACTUAL PROJECT SIZE DEFINITION page 8 


KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KK 


mmmsor SIZE IN DSI... ... . .... .. . . ~. RJBDSI 


The real size of the software project in delivered 
source instructions (DSI) with comments. The following 
definitions are from Boehm, 1981. 

Delivered. This term is generally meant to exclude 
nondelivered support software such as test drivers. However, 
if these are developed with the same care as delivered 
software, with their own reviews, test plans, documentation, 
etc., then they should be counted. 

Source Instructions. This term includes all program 
instructions created by project personnel and processed into 
machine code by some combination of preprocessors, compilers, 
and assemblers. It excludes comment cards and unmodified 


utility software. It includes job control language, 
format statements and data declarations. Instructions are 
defined as lines of code or card images. Thus, a line 


containing two or more source statements counts as one 
instruction; a £five-line data declaration counts as five 
mstcreuctions. 


Press Enter to Continue 
dendq 
choice 1 
@enaq 1/1 
cend 1/8 


display clear 


25 


KKK KKK KKK KKK KK KKK KKK KKK KK KEK KKK KKK KKK KKK KEK KK KKK KKK KK KKK 


VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 
DEFINITION page 9 


KKK K KKK KKK KEK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK K 


DELIVERED SOURCE INSTRUCTION PER TASK . . | eee Co DSTE a 


This parameter is set to the value of the nominal 
potential productivity in the organizational environment 
being modeled. For example, if the nominal potential 
productivity is 50 DSI/Man-Day then DSIPTK would be set to 
S0e 


ERROR RATE PER 1000 DELIVERED SOURCE 
INSTRUCTIONS (RDS)... 2 4, See ene 

TNERPK is the number of errors committed on the average, 
per 1000 DSI, as the software project is being developed. [ft 
is not a single number but rather a table function. This 
allows the user to set different error rates at different 
stages of the project's lifecycle. 


Press Enter to Continue 
dendg 


chodececsr 
cend 1/1 


display clear 

KKK KKK KKK KEKE KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KEKE KKK KKK 
VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 
DEFINITION page 10 


KKK K KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KK KKK KKK KKK KKK KKK KK KKK 


HERING .DELAY aes . . » . HGREDY 
HIREDY is the Beeson Jehas Siac. in work days, incurred 
in adding new staff members to the project. 


ASSIMILATION DELAY .. . > inal see 
ASIMDY is the average one needa to assimilate new 
hirees into the project, measured in workdays. Fe ws the 


time required for orientation, institutionalization and 
Eralning- 


Press Enter to Continue 
dendg 


choice l 
cend l/l 
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display clear 

KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 
VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 

DEFINITION page ll 


KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


PeeeeGe SSMPMOYMENT .@2 .@. mm . . m.mme..... AVEMPT 


AVEMPT is the average employment time of project team 
members, measured in working days. It is indirectly 
MeepOoreional with TURNOVER. For example, »the smaller the 
AVEMPT the larger the turnover rate, and conversely, the 
smaller the turnover rate the higher the AVEMPT. 


Press Enter to Continue 
dendq 
choice 1 
eend 1/1 


cend 2/8 


display clear 
KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK 


POLICY VARIABLES DEFINITIONS page 12 
KkKKk KKK KKK KKK KKK KKK KK KKK KKK RK KKK RK KK KK kK RKO Kk Kk kK 
fee NDER ESTIMATION FACTOR ......... . . . UNDEST 


Undersizing is a large problem in project management. 
This variable allows the to experiment with different values 
of underestimates. Thus to simulate a situation where the 
project size is initially underestimated by 25 %, this 
Variable would be set to 0.25. 


Metweeinn DAYS . . . . . »« « . » « » « » vate TOTMDL 

TOTMD1 is the man-day estimate produced at the start of 
the project, for design, coding and system testing of the 
project. 


MemmrmebomemvELOP 2. . . 6k kw wl UU ell lll lhl wlhlUe).!©6UmTTDEVI 


TDEV1 represents the estimated time, measured in work 
days, for the design, coding and testing stages of the 
project, produced at the start of the project. For example, 
if the initial project duration estimate was 16 months, 
TDEV1 would be equal to (16 x 20) or 320 working days. 


Press Enter to Continue 
dendgq 
choice 1 


oF, 


cend l/l 


Gisplay clear 
KKK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK 


POLICY VARIABLES DEFINITIONS page 13 
KOK KK OK KO KK KO RK I I IK I kk 
% OF EFFORT ASSUMED NEEDED FOR DEVELOPMENT... . DEVPRT 


This variable is used to allocate the projected total 
budget, measured in Man-Days, for the development (which 
includes design and coding) and testing phases. For example, 
if it is decided that 80 % of the total Man-Days would be 
allocated to development and 20 % to testing, then DEVPRT 
would be set to 0.80. 


FRACTION OF MANPOWER DEVOTED TO QUALITY 
ASSURANCE . . © © . s 1-3 ] 2 DPM 

TPFMQOA is the percent of development effort allocated in 
the project's plan for QA activities during the design and 
coding stages. It is not a single number but rather a table 
function that allows the user to change the number of 
Man-Days allocated to QA at different stages in the project 
lifecycle. A value of 0.20 at some point in the project 
would indicate that at this point, 20 % of the Man-Day budget 
is allocated to QA. 


Press Enter to Continue 
dendgq 
chowees 1 
cend 1/1 


display clear 
KKK KKK KKK KKK KKK KR KKK KKK KKK KKK KKK KKK KKK KK KKK KKK KK KKK KKK KKKSE 


POLICY VARIABLE DEFINITIONS page 14 
SESE CCCETCCLCTCCSCLSCLCLSLCTCCLC&CCLCLCCLCLCCCLCCCSCLC&CCLCTCCCSCCCCCCC.C SS SS: 
INITIAL UNDERSTAPFING FACTOR . . 35S eee oa 


The project's average staffing level is equal to the 
project's total number od Man-Days divided by the project's 
scheduled duration. Typically, the project will start witha 
small core team which grows in size. This variable specifies 
the size of the starting group. Thus a value of 0.5 
indicates that the startup team is half the size of the 
average staf£ Size. 


Press Enter To Continue 
dendgq 
choice l 
cend 1/1 


display clear 
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KKK KKKR KKK KKK KEK KKK KKK KKK KK KKK KKK KKK KKK KK KEK KERR KKKKK KKK KKK 


POLICY VARIABLES DEFINITIONS page 15 

KKK RRR KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KR KKK KKK KKK KKK KK 
WILLINGNESS TO CHANGE THE WORKFORCE ...... . .WCWFI1 

On deciding upon a "Workforce" level desired, project 
managers typically consider a number of factors. One 
important factor is the project's scheduled completion date. 
As part of the planning function, management determines the 
workforce level that it believes is necessary to complete the 
project on schedule. In addition to this factor, 
consideration is also given to the stability of the 
workforce. Thus, before adding new project members, 
management tries to contemplate the project employment for 
new members. Different organizations weigh this factor 
differently. In general, the relative weighing between th 
desire for workforce stability on one hand and the desire to 
complete the project on time, on the other, is not static, 
but changes dynamically throughout the lifecycle of the 
project. For example, toward the end of the project there is 
typically considerable reluctance to bring in new people, 
even if the project is behind schedule. It would take 
too much time and effort ( relative to the time and effort 
that are remaining) to acquaint new people with the mechanics 
of the project, integrate them into the project team and 
train them in the necessary technical areas. 


Press Enter for More Information of WCWF1 


dendg 
choice l 
cend l/l 


display clear 
RR RK KKK KKK KK RRR KKK KR KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK K KKK KK 


WCWF1 DEFINITION CONTINUE page 16 

RRR RRR KK RK KKK KKK KK KKK RRR KR RK RR KKK KKK KKK KK KKK KKK KKK KKK KK 
These managerial considerations are operational in the 

model as follows: 
WORKFORCE LEVEL NEEDED = (INDICATED WORKFORCE LEVEL) * (WCWF) 
+ (CURRENT WORKFORCE) * (1-WCWF) 

The Weighting Factor (WCWF) is termed Willingness to 
Change the Workforce. 


In the early stages of the project when "Time Remaining" 
is generally much larger than the sum of "Hiring Delay" and 
the "Average Assimilation Delay" WCWF would be equal to 1. 
When WCWF is = 1, the "Workforce Level Needed" in the above 
equation would simply be equal to the "Indicated Workforce 
Level," i.e@., management would be adjusting its workforce 
size to the level it feels is needed to finish on schedule. 
The "Indicated Workforce Level" can be determined by dividing 
the amount of effort that management percieves is still 


g2 


remaining (in Man-Days) by the time remaining to complete the 
project in days. 

When the "Time Remaining" decreases, ASSIMILATION DELAY 
(ASIMDY) could be set to equal exactly 0. The "Workforce 
Level Needed" in the equation would thus be equal to the 
"Current Workforce" 1.e., management attempts to maintain 
the projects workforce at its current level, and make 
adjustments to the schedule instead. 

Press Enter to Continue 
dendg 
choice l 
cend l/l 


display clear 
KEK KKKKE KKK KKK KEK KKK KK KKK KKK KEK KERR KKK KERR KKK KKK 


POLICY VARIABLE DEFINITIONS page 17 


KKK KK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KR KKK KEIRA KKK KKKEKKKEK 


TRAINERS PER NEW EMBLOYEER ~ « . 9. 3. Fee Ree 

In most organizations, training of new employees is 
carried out by the more experienced employees. This variable 
defines the fraction of an experienced staff member's time 
that is devoted to train new hirees. For example, a value of 
0.2 indicates that on the average each new employee 
consumes 20 %* of an experienced employee's time for the 
duration of the assimilation delay. 


AVERAGE DAILY MANPOWER PER STAFF EXPENDED ON 
PROJECT ~ s..-4 + «© « «© “GABMBES 

Project members are often only assigned part-time toa 
project. ADMPPS defines the %* of time that the team members 
devote, on an average to the particular project being 
Simulated. For example, if staf£ members tend to divide 
their time equally between two projects, i.e., half of their 
time is spent on project A and the other half is spent on 
project B, then ADMPPS would be = 0.5. 


Press Enter to Continue 
dendq 
choice 1 
Geng Vly 
cend 3/5 


display clear 


KEKE KE KKK RK KEK KKK KKK KEKE KKK KKK KKK KK KKK KKH KKK KKK KKK KH 


MODEL CONTROL VARIABLE DEFINITIONS page 18 
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MAX LENGTH OF PROJECT . 5. i ee ee 


100 


This model control variable 1s useful in controlling the 
Simulations. It precludes the model from continuing a 
Simulation beyond a predetermined length, e.g., 1000 days. 


PeeeePERTOD FOR DATA ....... .. . « « » » SAVPER 
This model control varaible allows the user to adjust 
the models save period for data for later viewing. For 


example, if the user sets the SAVPER = 1, the model will save 
all variable values on a daily basis, this data would be 
available for the usedr to examine and plot at the end of a 
Simulation. A SAVPER of 10, saves values every 10 days. This 
provides the user with a trade off between the time required 
for a Simulation and the level of detail of the results. 


Press Enter to Continue 
dendqd 
choice 1 
@end 1/1 
cend 4/8 


display clear 
KRREKKRKRKKRKRKKRKKRKRKKRKRKR KEK KKRKRKRKKRKRKRKKRKRKRKRKR KKK KKK KERR KKEKE KK KKK 
ESTIMATED ACTUAL PROJECT SIZE VARIABLE MANIPULATION 

page 19 * 
KERR KEKE KEK KEK KKK KKR KKK KKK KKK KKK KEKRKKK KKK KKK KKK KKK KKK 
Pee JOB SIZE IN DELIVERED SOURCE 
Meer lONS ~— 4. & . « 4 we S 2s RIBDSI 


Enter a new value for REAL JOB SIZE IN DELIVERED SOURCE 
INSTRUCTIONS or press enter to use the preset value. The 
preset value is written using a form of scientific notation 
where e3 represents x 10 to the third power. You do not have 
to enter a value in that format but be aware that the model 
will represent numbers in that format. 
dendgq 
cq rjbdsi=24.4e3 


eend 5/8 


display clear 
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Enter a new value for DELIVERED SOURCE INSTRUCTIONS PER 
TASK or press enter to use the preset value. 
dendq 
cq dsiptk=40.0 


display clear 
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Enter a new value for ERROR RATE PER 1000 DELIVERED 
SOURCE INSTRUCTIONS or press enter to use the preset value. 


1 Z 3 4 a 6 
dendq 
cq tnerpk=24, 2229 720m so, fo" 25,1 cee eee 


display clear 
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Enter a new value for HIRING DELAY or press enter to use 
the preset value. 


dendg 
cq hiredy=30. 


display clear 
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OZ 


Enter a new value for ASSIMILATION DELAY or press enter 
to use the preset value. 
dendg 
cq asimdy=21.0 


display clear 
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Enter a new value for AVERAGE EMPLOYMENT or press enter 
to use the preset value. 


dendg 
cq avempt=1000 


cend 6/8 


display clear 
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For assigning values to TOTAL MANDAYS and TIME TO 
DEVELOPE the user may either: 
1. Calculate the two values external to the model 
and input them directly at the prompt below. 


OR 


Z. Allow the model to calculate the two values 
macernally utilizing COCMOC by inputing 0 for each of the 2 
variables at the COCMO prompt. 


POTrMp) 
TDEV1 
dend 
cq totmdl=1111 
cq tdevl=320 
display 
COCOMO PROMPT: 
Enter 1 at the next two prompts to allow COCOMO to compute 
LOTMD] AND TDEV1. 
OR enter 0 to use your own values input above. 


OTS 


dend 

cq scswch=0 

cq mdswch=0 
pjbdsi=rjbdsi*(l-undest) 


display 
TOTMD1=((2.4*EXP(1.05*LOGN(pjbdsi/1000)))*19. 
dendg 


display 
TDEVI=((19*2.5*BAP(O0e 3S ROGN Groene oe 
dendq 


display 
#TDEV1I 


Press Enter to Continue 
dendgq 


ehnowce sa 
cend 1/1 


display clear 
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Enter a new value for TASK UNDER ESTIMATION FACTOR or 
press enter to use the preset value. 


dendg 
cq undeste=. 35 


display clear 
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Enter a new value for % OF EFFORT ASSUMED NEEDED FOR 
DEVELOPMENT or press enter to use the preset value. 


dendgq 
cq devprt=.5 
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display clear 
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Enter a new value for FRACTION OF MANPOWER DEVOTED TO 
QUALITY ASSURACE or press enter to use the preset value. 
I a 3 4 5 6 7 8 9 10 11 


dendgq 
Erna 75, 29,.2/75,.2595,.25,.275,.325,.375,.4,.4,0.0 


display clear 
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Enter a new value for INITIAL UNDERSTAFFING FACTOR or 
press enter to use the preset value. 


dendg 
cq inudst=.4 


display clear 
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Enter a new value for WILLINGNESS TO CHANGE THE WORKFORCE 
Or press enter to use the preset value. 


1 Z 3 4 5 6 ik 8 2 iM~eoeles 2° 13 ~14 
dendq 
dq 


fever OrOrmOee. |, .4,.85, |. 07120712071 .071.0,1.0,1.0,1.0,1.0 


IL/G S: 


display clear 
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Enter a new value for % OF EXPERIENCED EMPLOYEE EFFORT TO 
TRAIN A NEW EMPLOYEE or press enter to use the preset value. 


dendg 
CQOmEnpnNE=.25 


display clear 
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Enter a new value for AVERAGE DAILY MANPOWER PER STAFF 
EXPENDED ON PROJECT TO TRAIN A NEW EMPLOYEE oor press enter 
to use the preset value. 
dendgq 
cq admpps=.5 


cend 7/8 


display clear 
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Enter a new value for MAX LENGTH OF PROJECT or press 
enter to use the preset value. 


dendq 
cq maxlen=1000 
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display clear 
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Enter a new value for SAVE PERIOD FOR DATA or press 
enter to use the preset value. 


dendq 
cq savper=10 


cend 8/8 


ao C 


BG 


PO. 


lag 


eae 


eS 


14. 
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